.\" auto-generated by docbook2man-spec $Revision: 1.2 $
.TH "LSHW" "1" "30 May 2010" "$Rev: 2179 $" ""
.SH NAME
lshw \- list hardware
.SH SYNOPSIS
.sp
\fBlshw\fR [ \fB-version\fR ] 
.sp
\fBlshw\fR [ \fB-help\fR ] 
.sp
\fBlshw\fR [ \fB-X\fR ] 
.sp
\fBlshw\fR [ \fB [ -html ]  [ -short ]  [ -xml ]  [ -json ]  [ -businfo ] \fR ]  [ \fB-dump \fIfilename\fB\fR ]  [ \fB-class \fIclass\fB\fR\fI...\fR ]  [ \fB-disable \fItest\fB\fR\fI...\fR ]  [ \fB-enable \fItest\fB\fR\fI...\fR ]  [ \fB-sanitize\fR ]  [ \fB-numeric\fR ]  [ \fB-quiet\fR ] 
.SH "DESCRIPTION"
.PP

\fBlshw\fR
is a small tool to extract detailed information on the hardware
configuration of the machine. It can report exact memory
configuration, firmware version, mainboard configuration, 
CPU version
and speed, cache configuration, bus speed, etc. on 
DMI-capable x86 or IA-64
systems and on some PowerPC
machines (PowerMac G4 is known to work).
.PP
It currently supports DMI (x86 and IA-64 only), OpenFirmware device tree (PowerPC only),
PCI/AGP, CPUID (x86), IDE/ATA/ATAPI, PCMCIA (only tested on x86), SCSI and USB\&.
.PP
.TP
\fB-version\fR
Displays the version of \fBlshw\fR and exits.
.TP
\fB-help\fR
Displays the available command line options and quits.
.TP
\fB-X\fR
Launch the X11 GUI (if available).
.TP
\fB-html\fR
Outputs the device tree as an HTML page.
.TP
\fB-xml\fR
Outputs the device tree as an XML tree.
.TP
\fB-json\fR
Outputs the device tree as a JSON object (JavaScript Object Notation).
.TP
\fB-short\fR
Outputs the device tree showing hardware paths, very much like the output of HP-UX\&'s \fBioscan\fR\&.
.TP
\fB-businfo\fR
Outputs the device list showing bus information, detailing SCSI, USB, IDE and PCI addresses.
.TP
\fB-dump \fIfilename\fB\fR
Dump collected information into a file (SQLite database).
.TP
\fB-class \fIclass\fB\fR
Only show the given class of hardware. \fIclass\fR can be found using \fBlshw -short\fR or \fBlshw -businfo\fR\&.
.TP
\fB-C \fIclass\fB\fR
Alias for \fB-class\fR \fIclass\fR\&.
.TP
\fB-enable \fItest\fB\fR
.TP
\fB-disable \fItest\fB\fR
Enables or disables a test. \fItest\fR can be \fBdmi\fR (for DMI/SMBIOS extensions), \fBdevice-tree\fR (for OpenFirmware device tree), \fBspd\fR (for memory Serial Presence Detect), \fBmemory\fR (for memory-size guessing heuristics), \fBcpuinfo\fR (for kernel-reported CPU detection), \fBcpuid\fR (for CPU detection), \fBpci\fR (for PCI/AGP access), \fBisapnp\fR (for ISA PnP extensions), \fBpcmcia\fR (for PCMCIA/PCCARD), \fBide\fR (for IDE/ATAPI), \fBusb\fR (for USB devices),\fBscsi\fR (for SCSI) or \fBnetwork\fR (for network interfaces detection).
.TP
\fB-quiet\fR
Don't display status.
.TP
\fB-sanitize\fR
Remove potentially sensitive information from output (IP addresses, serial numbers, etc.).
.TP
\fB-numeric\fR
Also display numeric IDs (for PCI and USB devices).
.SH "BUGS"
.PP
\fBlshw\fR currently does not detect 
Firewire(IEEE1394) devices.
.PP
Not all architectures supported by GNU/Linux are fully supported (e.g.
CPU detection).
.PP
"Virtual" SCSI interfaces used for SCSI emulation over IDE are not reported correctly yet.
.SH "NOTES"
.PP
\fBlshw\fR must be run as super user or it will only report
partial information.
.SH "FILES"
.PP
.TP
\fB/usr/local/share/pci.ids\fR
.TP
\fB/usr/share/pci.ids\fR
.TP
\fB/etc/pci.ids\fR
.TP
\fB/usr/share/hwdata/pci.ids\fR
A list of all known PCI ID's (vendors, devices, classes and subclasses).
.TP
\fB/proc/bus/pci/*\fR
Used to access the configuration of installed PCI busses and devices.
.TP
\fB/proc/ide/*\fR
Used to access the configuration of installed IDE busses and devices.
.TP
\fB/proc/scsi/*, /dev/sg*\fR
Used to access the configuration of installed SCSI devices.
.TP
\fB/dev/cpu/*/cpuid\fR
Used on x86 platforms to access CPU-specific configuration.
.TP
\fB/proc/device-tree/*\fR
Used on PowerPC platforms to access OpenFirmware configuration.
.TP
\fB/proc/bus/usb/*\fR
Used to access the configuration of installed USB busses and devices.
.TP
\fB/sys/*\fR
Used on 2.6 kernels to access hardware/driver configuration information.
.SH "EXAMPLES"
.PP
.TP
\fBlshw -short\fR
Lists hardware in a compact format.
.TP
\fBlshw -class disk -class storage\fR
Lists all disks and storage controllers in the system.
.TP
\fBlshw -html -class network\fR
Lists all network interfaces in HTML.
.TP
\fBlshw -disable dmi\fR
Don't use DMI to detect hardware.
.SH "SEE ALSO"
.PP
\fI/proc/*\fR, \fBlinuxinfo\fR(1), \fBlspci\fR(8), \fBlsusb\fR(8)
.SH "COPYING"
.PP
\fBlshw\fR is distributed under the GNU GENERAL PUBLIC LICENSE (GPL) version 2.
.SH "AUTHOR"
.PP
\fBlshw\fR is maintained by Lyonel Vincent
<lyonel@ezix.org>\&.
.SH "OTHER INFO"
.PP
The webpage for \fBlshw\fR is at 
 <URL:http://lshw.org/>
