pciutils

This article is a stub. Please help out by expanding it - how to get started.

Resources

pciutils contains various utilities dealing with the PCI bus (primarily lspci). lspci is a hardware detection tool for system resources connected to the PCI bus.

Installation

USE flags

USE flags for sys-apps/pciutils Various utilities dealing with the PCI bus

`dns`	Enable support for querying the central database of PCI IDs using DNS
`kmod`	Enable sys-apps/kmod support for the -k switch in lspci command
`static-libs`	Build static versions of dynamic libraries as well
`udev`	Enable virtual/udev integration (device discovery, power and storage device support, etc)
`zlib`	Support compressed pci.ids database

Data provided by the Gentoo Package Database · Last update: 2023-06-11 20:44 More information about USE flags

Emerge

root #emerge --ask sys-apps/pciutils

lspci detects the devices based on an ID database provided by sys-apps/hwdata. To get a more recent database install a new(er) version of hwdata.

root #emerge --ask sys-apps/hwdata

Configuration

Files

/etc/conf.d/pciparm

Usage

Invocation

user $lspci help

Usage: lspci [<switches>]

Basic display modes:
-mm		Produce machine-readable output (single -m for an obsolete format)
-t		Show bus tree

Display options:
-v		Be verbose (-vv or -vvv for higher verbosity)
-k		Show kernel drivers handling each device
-x		Show hex-dump of the standard part of the config space
-xxx		Show hex-dump of the whole config space (dangerous; root only)
-xxxx		Show hex-dump of the 4096-byte extended config space (root only)
-b		Bus-centric view (addresses and IRQ's as seen by the bus)
-D		Always show domain numbers
-P		Display bridge path in addition to bus and device number
-PP		Display bus path in addition to bus and device number

Resolving of device ID's to names:
-n		Show numeric ID's
-nn		Show both textual and numeric ID's (names & numbers)

Selection of devices:
-s [[[[<domain>]:]<bus>]:][<slot>][.[<func>]]	Show only devices in selected slots
-d [<vendor>]:[<device>][:<class>]		Show only devices with specified ID's

Other options:
-i <file>	Use specified ID database instead of /usr/share/misc/pci.ids.gz
-p <file>	Look up kernel modules in a given file instead of default modules.pcimap
-M		Enable `bus mapping' mode (dangerous; root only)

PCI access options:
-A <method>	Use the specified PCI access method (see `-A help' for a list)
-O <par>=<val>	Set PCI access parameter (see `-O help' for a list)
-G		Enable PCI access debugging
-H <mode>	Use direct hardware access (<mode> = 1 or 2)
-F <file>	Read PCI configuration dump from a given file

Removal

Unmerge

root #emerge --ask --depclean --verbose sys-apps/pciutils