OS Manuals

/usr/bin/setpci

PCI bus configuration space access library and tools

From pciutils 3.10.0-r45 (os), captured 2026-11-07 by running setpci --help (exit 0). permalink

Usage: setpci [<options>] (<device>+ <reg>[=<values>]*)*

General options:
-f		Don't complain if there's nothing to do
-v		Be verbose
-D		List changes, don't commit them
-r		Use raw access without bus scan if possible
--dumpregs	Dump all known register names and exit

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)

Setting commands:
<device>:	-s [[[<domain>]:][<bus>]:][<slot>][.[<func>]]
		-d [<vendor>]:[<device>]
<reg>:		<base>[+<offset>][.(B|W|L)][@<number>]
<base>:		<address>
		<named-register>
		[E]CAP_<capability-name>
		[E]CAP<capability-number>
<values>:	<value>[,<value>...]
<value>:	<hex>
		<hex>:<mask>
Options (14)
OptionDescriptionSource
-fTells setpci not to complain when there's nothing to do (when no devices are selected).help + man
-vTells setpci to be verbose and display detailed information about configuration space accesses.help + man
-DDemo mode' -- don't write anything to the configuration registers.help + man
-rAvoids bus scan if each operation selects a specific device (uses the -s selector with specific domain, bus, slot, and function).help + man
--dumpregsShow a list of all known PCI registers and capabilities.help + man
-A methodThe library supports a variety of methods to access the PCI hardware.help + man
-O par>=<valThe behavior of the library is controlled by several named parameters.help + man
-GIncrease debug level of the library.help + man
-H modeUse direct hardware access (<mode> = 1 or 2)help
-d vendor>]:[<devicehelp
--versionShow setpci version. (in the manual page but not in --help)man
--helpShow detailed help on available options. (in the manual page but not in --help)man
-H1Use direct hardware access via Intel configuration mechanism 1. (in the manual page but not in --help)man
-H2Use direct hardware access via Intel configuration mechanism 2. (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.