Date: Tue, 10 Mar 2026 16:53:58 +0000 From: John Baldwin <jhb@FreeBSD.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org Subject: git: 98a0d2283701 - main - pciconf.8: Reorganize slightly to handle additional modes Message-ID: <69b04ca6.4568b.5c5c5c32@gitrepo.freebsd.org>
index | next in thread | raw e-mail
The branch main has been updated by jhb: URL: https://cgit.FreeBSD.org/src/commit/?id=98a0d2283701e08353ce670c8023803c58a4994c commit 98a0d2283701e08353ce670c8023803c58a4994c Author: John Baldwin <jhb@FreeBSD.org> AuthorDate: 2026-03-10 16:50:52 +0000 Commit: John Baldwin <jhb@FreeBSD.org> CommitDate: 2026-03-10 16:50:52 +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 --- 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,home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?69b04ca6.4568b.5c5c5c32>