History log of /freebsd-10.0-release/usr.sbin/pciconf/pciconf.8
Revision Date Author Comments
(<<< Hide modified files)
(Show modified files >>>)
# 259065 07-Dec-2013 gjb

- Copy stable/10 (r259064) to releng/10.0 as part of the
10.0-RELEASE cycle.
- Update __FreeBSD_version [1]
- Set branch name to -RC1

[1] 10.0-CURRENT __FreeBSD_version value ended at '55', so
start releng/10.0 at '100' so the branch is started with
a value ending in zero.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

# 256281 10-Oct-2013 gjb

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation


# 236415 01-Jun-2012 jhb

Add a new -e flag to pciconf(8)'s list mode to display PCI error details.
Currently this dumps the status of any error bits in the PCI status register
and PCI-express device status register. It also lists any errors indicated
by version 1 of PCI-express Advanced Error Reporting (AER).

MFC after: 1 week


# 233648 29-Mar-2012 eadler

Remove trailing whitespace per mdoc lint warning

Disussed with: gavin
No objection from: doc
Approved by: joel
MFC after: 3 days


# 212372 09-Sep-2010 jhb

Document the format of extended capabilities in the '-c' output.


# 211397 16-Aug-2010 joel

Fix typos, spelling, formatting and mdoc mistakes found by Nobuyuki while
translating these manual pages. Minor corrections by me.

Submitted by: Nobuyuki Koganemaru <n-kogane@syd.odn.ne.jp>


# 188018 02-Feb-2009 jhb

- Add a new ioctl to /dev/pci to fetch details on an individual BAR of a
device. The details include the current value of the BAR (including all
the flag bits and the current base address), its length, and whether or not
it is enabled. Since this operation is not invasive, non-root users are
allowed to use it (unlike manual config register access which requires
root). The intention is that userland apps (such as Xorg) will use this
interface rather than dangerously frobbing the BARs from userland to
obtain this information.
- Add a new sub-mode to the 'list' mode of pciconf. The -b flag when used
with -l will now list all the active BARs for each device.

MFC after: 1 month


# 173415 07-Nov-2007 marck

devinfo(8) manual page refers to pciconfr(8). Add back reference for
completeness.

MFC After: 2 weeks


# 172447 04-Oct-2007 se

Restore compatibility with version before introduction of PCI domains.
PCI selectors with 2 or 3 elements behave exactly as before (i.e. the
domain is 0 and in the 2 element case, the function is also 0).
The form with 4 selector elements works as in the previous revision
and provides the PCI domain number as the left-most selector element.

This change allows old scripts (which used the 2 or 3 selector element
formats) to be kept. Without this patch, the 3 element form was parsed
as starting with a domain number (and the function was assumed to be 0),
with this patch, the domain is assumed to be 0 (and the last value is
used as the function number).

The man page is updated to describe the new selector semantics.

Approved by: re (Ken Smith)


# 172394 30-Sep-2007 marius

Make the PCI code aware of PCI domains (aka PCI segments) so we can
support machines having multiple independently numbered PCI domains
and don't support reenumeration without ambiguity amongst the
devices as seen by the OS and represented by PCI location strings.
This includes introducing a function pci_find_dbsf(9) which works
like pci_find_bsf(9) but additionally takes a domain number argument
and limiting pci_find_bsf(9) to only search devices in domain 0 (the
only domain in single-domain systems). Bge(4) and ofw_pcibus(4) are
changed to use pci_find_dbsf(9) instead of pci_find_bsf(9) in order
to no longer report false positives when searching for siblings and
dupe devices in the same domain respectively.
Along with this change the sole host-PCI bridge driver converted to
actually make use of PCI domain support is uninorth(4), the others
continue to use domain 0 only for now and need to be converted as
appropriate later on.
Note that this means that the format of the location strings as used
by pciconf(8) has been changed and that consumers of <sys/pciio.h>
potentially need to be recompiled.

Suggested by: jhb
Reviewed by: grehan, jhb, marcel
Approved by: re (kensmith), jhb (PCI maintainer hat)


# 166528 06-Feb-2007 ru

- Bump document date.
- Kill whitespace at EOL.
- Add missing markup bit.


# 166435 02-Feb-2007 jhb

- Teach pciconf(8) to list the PCI capabilities supported by each device
via a new -c flag to be used with -l. Some simple parsing code is
present for the following capabilities: Power Management, AGP, VPD,
MSI, PCI-X, HyperTransport, Vendor-specific, EHCI Debug Port, PCI-PCI
bridge subvendor ID, PCI-express, and MSI-X.
- Fix a few warnings in pciconf.c.
- Update some cruft in pciconf(8):
- PCI 2.1 is no longer a revolutionary standard, and subvendor ID's are
fairly common at this point, so reflect that.
- Header type 2 is used for PCI-CardBus bridges.
- Describe the -v option for -l after completing the basic -l description
instead of disrupting the flow in the middle.

Reviewed by: imp (partially)
MFC after: 1 week


# 124192 06-Jan-2004 rwatson

Update pciconf man page to indicate that only some of the functions
in pciconf are limited to the superuser.

Requested by: ru


# 115223 22-May-2003 ru

Moved $FreeBSD$ tag to where it belongs.

Approved by: re (blanket)


# 108987 09-Jan-2003 trhodes

Fix up some grammar.

Noticed by: sheldonh


# 107871 14-Dec-2002 trhodes

Markup fixes. Document more correctly.

PR: 43678
Submitted by: ru


# 103499 17-Sep-2002 jdp

Use consistent terminology in the usage message, the man page
synopsis, and the man page description ("selector" vs. "sel" and
"addr" vs. "reg").

Fix the usage message and man page synopsis to show that the "value"
argument is not optional.


# 101828 13-Aug-2002 ru

mdoc(7) police: Removed redundant .Ns calls.


# 99968 14-Jul-2002 charnier

The .Nm utility


# 97562 30-May-2002 ru

mdoc(7) police: make SYNOPSIS really match usage().


# 96678 15-May-2002 trhodes

pciconf(8) has an incorrect synopsis which argues the output from the
actual program.


# 86966 27-Nov-2001 sheldonh

Add missing -v option to the SYNOPSIS.


# 81588 13-Aug-2001 ru

Spell "FreeBSD" with "F" and "BSD" in uppercase.


# 79755 15-Jul-2001 dd

Remove whitespace at EOL.


# 79537 10-Jul-2001 ru

mdoc(7) police: removed HISTORY info from the .Os call.


# 77533 31-May-2001 imp

Support a range of registers to read.
eg pciconf -r pci0:10:0 0:0xff
and keep the output of the old singleton the same.

Reviewed by: audit@, dd

MFC after: 10 days


# 69700 07-Dec-2000 msmith

Update to improve handling of verbose PCI vendor/device information.

- Read the database from /usr/share/misc (or wherever else we're pointed)
rather than compiling it in.
- Decode the class/subclass fields if requested.
- Print things in a slightly longer but more readable format.


# 69027 22-Nov-2000 ru

mdoc(7) police: do not split author names in the AUTHORS section.


# 68965 20-Nov-2000 ru

mdoc(7) police: use the new features of the Nm macro.


# 68677 13-Nov-2000 msmith

Add support for decoding the PCI vendor and device ID registers. Add a
database of about 1400 vendors and 2700 devices courtesy of
www.yourvote.com/pci. We still need to add some more, but this is a good
start.


# 57673 01-Mar-2000 sheldonh

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.


# 53761 27-Nov-1999 charnier

.Fn -> .Xr
Do not start warn() message with uppercase.


# 50479 27-Aug-1999 peter

$Id$ -> $FreeBSD$


# 45383 06-Apr-1999 ghelmer

Replace LKM with KLD.

Submitted by: Nathan Ahlstrom <nrahlstr@winternet.com>


# 41103 11-Nov-1998 ken

Modify pciconf(8) so that it will print out PCI devices that have no driver
configured in the kernel. It gives them a device name of "none" and
monotonically incrementing unit numbers. (starting at 0) Before, pciconf
would just skip over unconfigured devices. (unconfigured devices can be
detected because they have a null string for a device name)

Update the man page to reflect the new pciconf output. Unfortunately, this
causes the sample 'pciconf -l' output lines to wrap, but I'm not sure what
to do about that really.

If anyone presents a reasonable case for printing out something other than
"none1" for unconfigured devices, I'm willing to listen.


# 30172 06-Oct-1997 charnier

Sync usage string with man page.


# 22997 22-Feb-1997 peter

Revert $FreeBSD$ to $Id$


# 22574 11-Feb-1997 se

Man page for the pciconf utility. There really should be some
documentation on the ioctl() interface provided by /dev/pci ...

Reviewed by: wollman