| 1 |
.\"SPDX-License-Identifier: GPL-2.0-only |
| 2 |
.\"Copyright (c) 1999 Thomas Sailer <[email protected]> |
| 3 |
.TH lsusb 8 "11 February 2019" "usbutils" "Linux USB Utilities" |
| 4 |
.IX lsusb |
| 5 |
.SH NAME |
| 6 |
lsusb \- list USB devices |
| 7 |
.SH SYNOPSIS |
| 8 |
.B lsusb |
| 9 |
[ |
| 10 |
.I options |
| 11 |
] |
| 12 |
.SH DESCRIPTION |
| 13 |
.B lsusb |
| 14 |
is a utility for displaying information about USB buses in the system and |
| 15 |
the devices connected to them. It uses udev's hardware database to |
| 16 |
associate a full human-readable name to the vendor ID and the product ID. |
| 17 |
|
| 18 |
.SH OPTIONS |
| 19 |
.TP |
| 20 |
.BR \-v ", " \-\-verbose |
| 21 |
Tells |
| 22 |
.I lsusb |
| 23 |
to be verbose and display detailed information about the devices shown. |
| 24 |
This includes configuration descriptors for the device's current speed. |
| 25 |
Class descriptors will be shown, when available, for USB device classes |
| 26 |
including hub, audio, HID, communications, and chipcard. Can be used with the |
| 27 |
\fB-t\fP option. |
| 28 |
.TP |
| 29 |
\fB\-s\fP [[\fIbus\fP]\fB:\fP][\fIdevnum\fP] |
| 30 |
Show only devices in specified |
| 31 |
.I bus |
| 32 |
and/or |
| 33 |
.IR devnum . |
| 34 |
Both IDs are given in decimal and may be omitted. |
| 35 |
.TP |
| 36 |
\fB\-d\fP [\fIvendor\fP]\fB:\fP[\fIproduct\fP] |
| 37 |
Show only devices with the specified vendor and product ID. |
| 38 |
Both IDs are given in hexadecimal. |
| 39 |
.TP |
| 40 |
.B \-D \fIdevice\fP |
| 41 |
Do not scan the /dev/bus/usb directory, |
| 42 |
instead display only information |
| 43 |
about the device whose device file is given. |
| 44 |
The device file should be something like /dev/bus/usb/001/001. |
| 45 |
This option displays detailed information like the \fB-v\fP option; |
| 46 |
you must be root to do this. |
| 47 |
.TP |
| 48 |
.BR \-t ", " \-\-tree |
| 49 |
Tells |
| 50 |
.I lsusb |
| 51 |
to dump the physical USB device hierarchy as a tree. Verbosity can be increased twice with the |
| 52 |
\fB-v\fP option. |
| 53 |
.TP |
| 54 |
.BR \-V ", " \-\-version |
| 55 |
Print version information on standard output, |
| 56 |
then exit successfully. |
| 57 |
|
| 58 |
.SH RETURN VALUE |
| 59 |
If the specified device is not found, a non-zero exit code is returned. |
| 60 |
|
| 61 |
.SH SEE ALSO |
| 62 |
.BR lspci (8), |
| 63 |
.BR usbview (8). |
| 64 |
|
| 65 |
.SH AUTHOR |
| 66 |
Thomas Sailer, <[email protected]>. |