1.\" $OpenBSD: pcidump.8,v 1.12 2013/07/16 11:13:34 schwarze Exp $ 2.\" 3.\" Copyright (c) 2007 Paul de Weerd <weerd@weirdnet.nl> 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd $Mdocdate: July 16 2013 $ 18.Dt PCIDUMP 8 19.Os 20.Sh NAME 21.Nm pcidump 22.Nd show PCI device data 23.Sh SYNOPSIS 24.Nm pcidump 25.Op Fl v 26.Op Fl x | xx | xxx 27.Op Fl d Ar pcidev 28.Sm off 29.Op Ar bus : dev : func 30.Sm on 31.Nm pcidump 32.Fl r Ar file 33.Op Fl d Ar pcidev 34.Sm off 35.Ar bus : dev : func 36.Sm on 37.Sh DESCRIPTION 38The 39.Nm 40utility displays the device address, vendor, and product name 41of PCI devices. 42When no arguments are given, 43information on all PCI devices in the system is shown; 44otherwise a single PCI domain or device may be specified. 45.Pp 46The options are as follows: 47.Bl -tag -width Ds 48.It Fl d Ar pcidev 49Specify a file to use for PCI lookups. 50If specified without 51.Sm off 52.Ar bus : dev : func , 53.Sm on 54all PCI devices in the domain will be shown. 55.It Fl r Ar file 56Reads the PCI ROM from the device specified by 57.Sm off 58.Ar bus : dev : func , 59.Sm on 60and writes its contents to 61.Ar file . 62.It Fl v 63Shows detailed information about PCI devices. 64.It Fl x 65Shows a hexadecimal dump of the first 64 bytes of PCI config space. 66.It Fl xx 67Shows a hexadecimal dump of the full PCI config space. 68.It Fl xxx 69Shows a hexadecimal dump of the PCIe extended config space. 70.It Xo 71.Sm off 72.Ar bus : dev : func 73.Sm on 74.Xc 75Show information about the PCI device specified by the tuple given on 76the command line. 77If the 78.Fl d 79option is not given, 80.Pa /dev/pci 81is used. 82.El 83.Sh FILES 84.Bl -tag -width /dev/pci* -compact 85.It Pa /dev/pci* 86Device files for accessing PCI domains. 87.El 88.Sh SEE ALSO 89.Xr pci 4 90.Sh HISTORY 91The 92.Nm 93utility first appeared in 94.Ox 4.3 . 95.Sh AUTHORS 96.An -nosplit 97The 98.Nm 99utility was written by 100.An David Gwynne Aq Mt dlg@openbsd.org . 101.Sh BUGS 102The default behaviour of scanning all PCI domains is limited to those 103domains that have an entry in 104.Pa /dev . 105