From nobody Fri Apr 24 17:56:22 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 4g2LHV4J2Wz6Zxkr for ; Fri, 24 Apr 2026 17:56:22 +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 "R13" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4g2LHV26SLz3qT2 for ; Fri, 24 Apr 2026 17:56:22 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1777053382; 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=jFKXfuytrsKsuyvJ/D7GJVU18r99pASuk1WQ+swljhI=; b=VqW6xIQjHIk6y5T4TV0sr3KVGz5U/AqIQrh9crb2P8QcJ5ePIzA2dByb+0UzQkI48TyHTU BY72moTgk1O87oN6ftkE+u/BEL4QqndgTgeFFMsXQqtIPH9bwR0Jlwscy0NjH+5tbeFV0C K3q9B2bnvSo2T7+5n/P2sY6CM/dd2nToyBZOCEcL/Ztr3rvu98UgeNSY7+yt1Vx+ryNb5E kZEVh/oRU9QjN18CC1GDReZuULKHzu+X+zsDr83RWxcagDTNWJJG11r7FidbJ35GSumc0F quaM9gO2cDeqsXygpqRSNlzlzy9yD/nWbpVNvpKYcLlhAvQKRlXvuoYaC4IZNg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1777053382; a=rsa-sha256; cv=none; b=EBKexXpyjAmqQ0O5hKevMs6BdrD9EcmbM17xUpCf4sOmT4D6WzVDao28R1FIrcu3aBlygF eI4dTYDFY0QvtSzaAhJp1vWDsXPjpsCwEcI0ITUZyQexOr4Lcg+IA2SJCTpoj1GpHtAbHS Cs+YbpyPVeBNxzx2FbDfE+Rtpn6O13MFIF7bZ7BrdwtEIZotUnLLlH6lUcbR21NKv6vvZQ Mwp3Qz8KMb2/6j8GzozGDoiadMlC0AhxXG6lsN+B+W+emvnhujgt4RPPyYfmyumgzzLmkh fAlYbmnQCRnVIZ0R74JQyPGX9d0tLGrqGriZaZnVJMMVOwWKRMjS3b6oFtgMjw== 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=1777053382; 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=jFKXfuytrsKsuyvJ/D7GJVU18r99pASuk1WQ+swljhI=; b=JpdEhSv4dbaku9XR31wWneaiOvjcepn+HOGAfn7/NUL9Hvh9HJ9P1RVqtqSFr/YvjceVtB IIFAbsHe/kq/1y35pXbq06qyuoBMpmLMnYwAd+ydArlY9gNVWf9ebeJPxnYIg/9TBCSj8q 7PoTWlXBacdBHErtkfALP7vMxx/Y00pk2ouog2hgfmggMn2MqGSgvS0a4QdlNaa7RNsxWB 59/v5IVw/wlAnQGvxcwPWxLmpssF1p98f+W+qBSqmcfOibyDDRkOGeNhKphcHIccZbsyl5 f+dKHZWAOm/JrRD9poBENMstBWkr4v1yMd8/a4bnpv3VGMJOvY4OzWCgmO4jAw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4g2LHV1jNBz1CQR for ; Fri, 24 Apr 2026 17:56:22 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 1d112 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Fri, 24 Apr 2026 17:56:22 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: John Baldwin Subject: git: c4a3c64993fd - stable/15 - pciconf.8: Reorganize slightly to handle additional modes 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 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: jhb X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: c4a3c64993fd59ca07c066de81b5bb2bc7bea6e1 Auto-Submitted: auto-generated Date: Fri, 24 Apr 2026 17:56:22 +0000 Message-Id: <69ebaec6.1d112.47d4cee2@gitrepo.freebsd.org> The branch stable/15 has been updated by jhb: URL: https://cgit.FreeBSD.org/src/commit/?id=c4a3c64993fd59ca07c066de81b5bb2bc7bea6e1 commit c4a3c64993fd59ca07c066de81b5bb2bc7bea6e1 Author: John Baldwin AuthorDate: 2026-03-10 16:50:52 +0000 Commit: John Baldwin CommitDate: 2026-04-24 17:33:53 +0000 pciconf.8: Reorganize slightly to handle additional modes Move the description of the optional device argument earlier before describing individual command modes. Add a subsection for list mode and a second subsection for the other modes that work with a single device. Reviewed by: imp Sponsored by: Chelsio Communications Differential Revision: https://reviews.freebsd.org/D55773 (cherry picked from commit 98a0d2283701e08353ce670c8023803c58a4994c) --- usr.sbin/pciconf/pciconf.8 | 58 +++++++++++++++++++++------------------------- 1 file changed, 27 insertions(+), 31 deletions(-) diff --git a/usr.sbin/pciconf/pciconf.8 b/usr.sbin/pciconf/pciconf.8 index 6c67e9e50df6..c9cbe483a1ac 100644 --- a/usr.sbin/pciconf/pciconf.8 +++ b/usr.sbin/pciconf/pciconf.8 @@ -23,7 +23,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd May 19, 2025 +.Dd March 10, 2026 .Dt PCICONF 8 .Os .Sh NAME @@ -52,6 +52,31 @@ access to .Pa /dev/pci , normally only the super-user. .Pp +A +.Ar device +can be identified either by a device name if the device is +attached to a driver or by a selector. +Selectors identify a PCI device by its address in PCI config space and +can take one of the following forms: +.Pp +.Bl -bullet -offset indent -compact +.It +.Li pci Ns Va domain Ns \&: Ns Va bus Ns \&: Ns Va device Ns \&: \ +Ns Va function Ns +.It +.Li pci Ns Va bus Ns \&: Ns Va device Ns \&: Ns Va function Ns +.It +.Li pci Ns Va bus Ns \&: Ns Va device Ns +.El +.Pp +In the case of an abridged form, omitted selector components are assumed to be 0. +An optional leading device name followed by @ and an optional final colon +will be ignored; this is so that the first column in the output of +.Nm +.Fl l +can be used without modification. +All numbers are base 10. +.Ss List Mode With the .Fl l option, @@ -260,36 +285,7 @@ argument is given with the flag, .Nm will only list details about a single device instead of all devices. -.Pp -All invocations of -.Nm -except for -.Fl l -require a -.Ar device . -The device can be identified either by a device name if the device is -attached to a driver or by a selector. -Selectors identify a PCI device by its address in PCI config space and -can take one of the following forms: -.Pp -.Bl -bullet -offset indent -compact -.It -.Li pci Ns Va domain Ns \&: Ns Va bus Ns \&: Ns Va device Ns \&: \ -Ns Va function Ns -.It -.Li pci Ns Va bus Ns \&: Ns Va device Ns \&: Ns Va function Ns -.It -.Li pci Ns Va bus Ns \&: Ns Va device Ns -.El -.Pp -In the case of an abridged form, omitted selector components are assumed to be 0. -An optional leading device name followed by @ and an optional final colon -will be ignored; this is so that the first column in the output of -.Nm -.Fl l -can be used without modification. -All numbers are base 10. -.Pp +.Ss Device Information Modes With the .Fl a flag,