pciutils

From Gentoo Wiki
Jump to:navigation Jump to:search

This article is a stub. You can help by expanding it.

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

Emerge

root #emerge --ask sys-apps/pciutils

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

root #emerge --ask sys-apps/hwids

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

See also

  • Hardware detection — lists and describes utilities used to detect and provide information on hardware.
  • Lshw — a hardware detection utility for Linux.
  • Usbutils — a collection various utilities for querying the the Universal Serial Bus (USB).