| 1 |
.\"SPDX-License-Identifier: GPL-2.0-only |
| 2 |
.\"Copyright (c) 1999 Thomas Sailer <[email protected]> |
| 3 |
.\"Copyright (c) 2020 Sam Morris <[email protected]> |
| 4 |
.TH lsusb.py 1 "03 January 2024" "usbutils" "Linux USB Utilities" |
| 5 |
.IX lsusb.py |
| 6 |
.SH NAME |
| 7 |
lsusb.py \- list USB devices |
| 8 |
.SH SYNOPSIS |
| 9 |
.B lsusb.py |
| 10 |
[ |
| 11 |
.I options |
| 12 |
] |
| 13 |
.SH DESCRIPTION |
| 14 |
.B lsusb.py |
| 15 |
is a utility for displaying information about USB buses in the system and the |
| 16 |
devices connected to them. It uses the |
| 17 |
.B usb.ids |
| 18 |
file to associate a human-readable name to the vendor and product IDs. |
| 19 |
.PP |
| 20 |
In comparison with |
| 21 |
.BR lsusb (8), |
| 22 |
this program can display additional information such as the interface speed of |
| 23 |
a device, and details of a device's interfaces including the driver bound to |
| 24 |
them and Linux devices provided by the driver, and the details of device and |
| 25 |
interface endpoints. |
| 26 |
.SH OPTIONS |
| 27 |
.TP |
| 28 |
.BR \-h ", " \-\-help |
| 29 |
Displays options supported by |
| 30 |
.BR lsusb (1). |
| 31 |
.TP |
| 32 |
.BR \-i ", " \-\-interfaces |
| 33 |
Display information about the interfaces of each device, excluding hubs. |
| 34 |
.TP |
| 35 |
.BR \-I ", " \-\-hub\-interfaces |
| 36 |
Display information about the interfaces of each device, including hubs., excluding hubs. |
| 37 |
.TP |
| 38 |
.BR \-u ", " \-\-hide\-empty\-hubs |
| 39 |
Suppress information about hubs that have no devices connected. |
| 40 |
.TP |
| 41 |
.BR \-U ", " \-\-hide\-hubs |
| 42 |
Suppress information about hubs, even if they have devices connected. |
| 43 |
.TP |
| 44 |
.BR \-c ", " \-\-color |
| 45 |
Use color |
| 46 |
.TP |
| 47 |
.BR \-C ", " \-\-no\-color |
| 48 |
Don't use color |
| 49 |
.TP |
| 50 |
.BR \-e ", " \-\-endpoints |
| 51 |
Include information about device (and interface, with |
| 52 |
.BR -i ) |
| 53 |
endpoints. |
| 54 |
.TP |
| 55 |
.BR \-f ", " \-\-usbids\-path |
| 56 |
Overrides the path of the |
| 57 |
.B usb.ids |
| 58 |
file. |
| 59 |
|
| 60 |
.SH SEE ALSO |
| 61 |
.BR lspci (8), |
| 62 |
.BR lsusb (8), |
| 63 |
.BR usbview (8). |
| 64 |
|
| 65 |
.SH AUTHOR |
| 66 |
Thomas Sailer, <[email protected]>, |
| 67 |
Sam Morris <[email protected]>. |