208 lines
5.1 KiB
HTML
208 lines
5.1 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of pcilib</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>pcilib</H1>
|
|
Section: The PCI Utilities (7)<BR>Updated: 25 January 2020<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
pcilib - a library for accessing PCI devices
|
|
<P>
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
The PCI library (also known as <I>pcilib</I> and <I>libpci</I>) is a portable library
|
|
for accessing PCI devices and their configuration space.
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>ACCESS METHODS</H2>
|
|
|
|
<P>
|
|
<P>
|
|
|
|
The library supports a variety of methods to access the configuration space
|
|
on different operating systems. By default, the first matching method in this
|
|
list is used, but you can specify override the decision (see the <B>-A</B> switch
|
|
of <I>lspci</I>).
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="1"><B>linux-sysfs</B>
|
|
|
|
<DD>
|
|
The
|
|
<B>/sys</B>
|
|
|
|
filesystem on Linux 2.6 and newer. The standard header of the config space is available
|
|
to all users, the rest only to root. Supports extended configuration space, PCI domains,
|
|
VPD (from Linux 2.6.26), physical slots (also since Linux 2.6.26) and information on attached
|
|
kernel drivers.
|
|
<DT id="2"><B>linux-proc</B>
|
|
|
|
<DD>
|
|
The
|
|
<B>/proc/bus/pci</B>
|
|
|
|
interface supported by Linux 2.1 and newer. The standard header of the config space is available
|
|
to all users, the rest only to root.
|
|
<DT id="3"><B>intel-conf1</B>
|
|
|
|
<DD>
|
|
Direct hardware access via Intel configuration mechanism 1. Available on i386 and compatibles
|
|
on Linux, Solaris/x86, GNU Hurd, Windows, BeOS and Haiku. Requires root privileges.
|
|
<DT id="4"><B>intel-conf2</B>
|
|
|
|
<DD>
|
|
Direct hardware access via Intel configuration mechanism 2. Available on i386 and compatibles
|
|
on Linux, Solaris/x86, GNU Hurd, Windows, BeOS and Haiku. Requires root privileges. Warning: This method
|
|
is able to address only the first 16 devices on any bus and it seems to be very
|
|
unreliable in many cases.
|
|
<DT id="5"><B>fbsd-device</B>
|
|
|
|
<DD>
|
|
The
|
|
<B>/dev/pci</B>
|
|
|
|
device on FreeBSD. Requires root privileges.
|
|
<DT id="6"><B>aix-device</B>
|
|
|
|
<DD>
|
|
Access method used on AIX. Requires root privileges.
|
|
<DT id="7"><B>nbsd-libpci</B>
|
|
|
|
<DD>
|
|
The
|
|
<B>/dev/pci0</B>
|
|
|
|
device on NetBSD accessed using the local libpci library.
|
|
<DT id="8"><B>obsd-device</B>
|
|
|
|
<DD>
|
|
The
|
|
<B>/dev/pci</B>
|
|
|
|
device on OpenBSD. Requires root privileges.
|
|
<DT id="9"><B>dump</B>
|
|
|
|
<DD>
|
|
Read the contents of configuration registers from a file specified in the
|
|
<B>dump.name</B>
|
|
|
|
parameter. The format corresponds to the output of <I>lspci</I> <B>-x</B>.
|
|
<DT id="10"><B>darwin</B>
|
|
|
|
<DD>
|
|
Access method used on Mac OS X / Darwin. Must be run as root and the system
|
|
must have been booted with debug=0x144.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>PARAMETERS</H2>
|
|
|
|
<P>
|
|
<P>
|
|
|
|
The library is controlled by several parameters. They should have sensible default
|
|
values, but in case you want to do something unusual (or even something weird),
|
|
you can override them (see the <B>-O</B> switch of <I>lspci</I>).
|
|
<P>
|
|
<A NAME="lbAF"> </A>
|
|
<H3>Parameters of specific access methods</H3>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="11"><B>dump.name</B>
|
|
|
|
<DD>
|
|
Name of the bus dump file to read from.
|
|
<DT id="12"><B>fbsd.path</B>
|
|
|
|
<DD>
|
|
Path to the FreeBSD PCI device.
|
|
<DT id="13"><B>nbsd.path</B>
|
|
|
|
<DD>
|
|
Path to the NetBSD PCI device.
|
|
<DT id="14"><B>obsd.path</B>
|
|
|
|
<DD>
|
|
Path to the OpenBSD PCI device.
|
|
<DT id="15"><B>proc.path</B>
|
|
|
|
<DD>
|
|
Path to the procfs bus tree.
|
|
<DT id="16"><B>sysfs.path</B>
|
|
|
|
<DD>
|
|
Path to the sysfs device tree.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H3>Parameters for resolving of ID's via DNS</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="17"><B>net.domain</B>
|
|
|
|
<DD>
|
|
DNS domain containing the ID database.
|
|
<DT id="18"><B>net.cache_name</B>
|
|
|
|
<DD>
|
|
Name of the file used for caching of resolved ID's.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H3>Parameters for resolving of ID's via UDEV's HWDB</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="19"><B>hwdb.disable</B>
|
|
|
|
<DD>
|
|
Disable use of HWDB if set to a non-zero value.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<P>
|
|
<B><A HREF="/cgi-bin/man/man2html?8+lspci">lspci</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+setpci">setpci</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+pci.ids">pci.ids</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+update-pciids">update-pciids</A></B>(8)
|
|
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
The PCI Utilities are maintained by Martin Mares <<A HREF="mailto:mj@ucw.cz">mj@ucw.cz</A>>.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="20"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="21"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="22"><A HREF="#lbAD">ACCESS METHODS</A><DD>
|
|
<DT id="23"><A HREF="#lbAE">PARAMETERS</A><DD>
|
|
<DL>
|
|
<DT id="24"><A HREF="#lbAF">Parameters of specific access methods</A><DD>
|
|
<DT id="25"><A HREF="#lbAG">Parameters for resolving of ID's via DNS</A><DD>
|
|
<DT id="26"><A HREF="#lbAH">Parameters for resolving of ID's via UDEV's HWDB</A><DD>
|
|
</DL>
|
|
<DT id="27"><A HREF="#lbAI">SEE ALSO</A><DD>
|
|
<DT id="28"><A HREF="#lbAJ">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:09 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|