Plan 9 from Bell Labs’s /usr/web/sources/contrib/quanstro/root/sys/man/8/pci

Copyright © 2021 Plan 9 Foundation.
Distributed under the MIT License.
Download the Plan 9 distribution.


.TH PCI 8
.SH NAME
pci, pcirw \- PCI space tools
.SH SYNOPSIS
.B pci
[
.B -cmv
]
[
.IR vid / did
|
.I bdf
...
]
.br
.B pcirw
.B -r
.I bdf
.I offset
.I width
.br
.B pcirw
.B -w
.I bdf
.I offset
.I width
.I value
.SH DESCRIPTION
.I Pci
normally prints one line per device found on the local PCI bus
described by
.BR #$/pci .
The fields are
.IB bus . device . function ,
class,
class code,
.IB vendor / device
ids,
IRQ (interrupt),
followed by the BAR (base address) registers in pairs of
.IB index : address
and
.IR size .
The
.B -v
option adds a second line per device, containing an English description
obtained from
.BR /lib/pci .
A second
.B -v
adds a second line of description based on the OEM.
.PP
.PP
Arbirary devices may also be looked up by giving their
PCI vendor and device ids on the command line. Specifying
a
.IR bdf s
on the command line, will print only the selected devices.
.PP
The
.B -c
option prints a one-line summary of PCI capabilities instead.
Each capability has the format
.IB name / capcode \fR.\fP
Combined with
.B -v
the capabilities' contents are decoded in human-readable format.
.PP
The
.B -m
option prints one line per device detailing the MSI (message-signaled
interrupt) configuration.  The fields are
.IB bus . device . function ,
flags, target address, target "data" and offset of the capability structure.
Combined with
.B -v
the flags are decoded in human-readable format.
.PP
.I Pcirw
reads 
.RB ( -r )
or writes 
.RB ( -w )
an integer of the specified
.I width
and the specified
.I offset
to or from PCI configuration space of a single specified device.
.SH FILES
.B /lib/pci
.SH SOURCE
.B /rc/bin/pci
.SH SEE ALSO
.IR pnp (3)
.SH BUGS
Due to constrants in the PCI standard, the BAR sizes are not
discoverable without corrupting them, so these must be provided
by the kernel pci device.

Bell Labs OSI certified Powered by Plan 9

(Return to Plan 9 Home Page)

Copyright © 2021 Plan 9 Foundation. All Rights Reserved.
Comments to [email protected].