This is Gentoo's testing wiki. It is a non-operational environment and its textual content is outdated.

Please visit our production wiki at https://wiki.gentoo.org

pciutils

From Gentoo Wiki (test)
Jump to:navigation Jump to:search

This article is a stub. You can help by expanding it.
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

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

root #lspci ?
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 for very verbose)
-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

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 --unmerge sys-apps/pciutils

See also

  • lshw - A "Hardware Lister" for Linux.
  • usbutils - Userspace utilities for collecting information from the USB bus.
  • Hardware detection - An article listing more "hardware detection" utilities.