From nobody Sun Aug 30 02:47:17 2026 X-Original-To: dev-commits-src-all@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 4hXc3V4l48z6q1bJ for ; Sun, 30 Aug 2026 02:47:18 +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 4hXc3T732Gz44Bb for ; Sun, 30 Aug 2026 02:47:17 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1788058038; 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=lYbO6heUjxwUuDx67T2CtuPT/lWqKGUJ2my+/Ul0HIc=; b=x122BWjxleQbeN+aApA7jhrNK72MqcDyhlOWUz2im/A2ik/ZXrSTXwFIievlVfmwfC976+ 4dmFeULAPEDvUTx8FWVv4k6BE8BSiu1jFrWJZdedkoBz10AOuayoVzxBRBXlCunMTgA3iH m/JGijK7IdTmWDXqXZsNj5d/7hIuC6I3oq58fa1ifZECiTuqp2MCCQ5lhE0NyYWqRZUG8O y73kT70OLmQLUj7TrC13eMnSJUf5/V8j6l2mQ79KXRGoEwhGBtymgmFx+7bkGHFLX/sv7W oZXd33gi2rOyNvjl9q6ySKQ0XRZ2rmvQFatN3OeqdtbepsQMY4rH3LQRGC7LHw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1788058038; a=rsa-sha256; cv=none; b=fi7vv7hbEECzfYQj4lTyRwqloD1MEtwp6YPhorBRqZgjgURoflZ6ZMJ/vlfJQBHzhnKveR KWo14ghHJdxqh6DhbFIxhjyV/TBQQrK7IBnKfOvl8HWe9Dy18nuBeMEl4IpQcxB3Bghh5M 1bVUFxt3DRkypGfo8KGiissFkPiATSKQ5TCfhIIdazpeFP+L3vcRTQ/bLMHHUL7rR8jz0W Wds9sOc2f5q69SPBxyCPuiyy7wnMmGFjdS9lM/eSrDYjczczr5s+TDE675pLoQwwSipfIU WDfzkd2LA5AwQM0oOKd1g4UEaM69kRmUMyppLpd+9zo82nzPttGWb4pFLV/8pQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1788058038; 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=lYbO6heUjxwUuDx67T2CtuPT/lWqKGUJ2my+/Ul0HIc=; b=oqNhOMKMpnAvwmzKD7eEHXfWd44gKPE5cuApaaoC6MuA8X33SN35ZzsoUVxrj79/zopDsB KPMazCDlrXcD122jcEAx/jRyfs/JjDUPd91NPyFLG5r0CJkqaeGmzjQ/jduKFEYULMDHoC mA1PZ6mQGDranwl3SW92lvSrjAk4EJhOO4MoQMjtdM//aR+gxL10xLs8oUUhYSE5mRWGzy 0fOvbDBBw2UDdnlMlssPn03vsaepiHqW8cLi+1ycsD4GbYPofHHyRvOWsBKS4cgh+Spnzj 4TUMPStYePceb4apRZof544lhmIeYAjcxOS75xsajeqO1c2Ow4RzsX0vlc/A+g== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4hXc3T4wnMz15wq for ; Sun, 30 Aug 2026 02:47:17 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 45e1d by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Sun, 30 Aug 2026 02:47:17 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Alexander Ziaee Subject: git: a416bbfa3972 - main - ntb_hw_plx.4: Canonicalize List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@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/main X-Git-Reftype: branch X-Git-Commit: a416bbfa3972249a8ab3b0d7cc39f3cd330f7012 Auto-Submitted: auto-generated Date: Sun, 30 Aug 2026 02:47:17 +0000 Message-Id: <6a9399b5.45e1d.3fc7f6bb@gitrepo.freebsd.org> The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=a416bbfa3972249a8ab3b0d7cc39f3cd330f7012 commit a416bbfa3972249a8ab3b0d7cc39f3cd330f7012 Author: Alexander Ziaee AuthorDate: 2026-08-30 02:36:59 +0000 Commit: Alexander Ziaee CommitDate: 2026-08-30 02:44:37 +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 --- 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 ,