Debian Codegraph @

upstream/debian-unstable/man8/lsusb.8

raw
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]>.