1lsusb(8)                      Linux USB Utilities                     lsusb(8)
2
3
4

NAME

6       lsusb - list USB devices
7

SYNOPSIS

9       lsusb [ options ]
10

DESCRIPTION

12       lsusb  is  a  utility for displaying information about USB buses in the
13       system and the devices connected to them.
14
15       To make use of all the features of this program, you  need  to  have  a
16       Linux  kernel  which  supports the /proc/bus/usb interface (e.g., Linux
17       kernel 2.3.15 or newer).
18
19

OPTIONS

21       -v, --verbose
22              Tells lsusb to be verbose and display detailed information about
23              the  devices shown.  This includes configuration descriptors for
24              the device's current speed.  Class descriptors  will  be  shown,
25              when  available,  for  USB  device classes including hub, audio,
26              HID, communications, and chipcard.
27
28       -s [[bus]:][devnum]
29              Show only devices in specified bus and/or devnum.  Both ID's are
30              given in decimal and may be omitted.
31
32       -d [vendor]:[product]
33              Show  only  devices  with  the  specified vendor and product ID.
34              Both ID's are given in hexadecimal.
35
36       -D device
37              Do not scan the /proc/bus/usb directory,  instead  display  only
38              information  about  the  device whose device file is given.  The
39              device file  should  be  something  like  /proc/bus/usb/001/001.
40              This option displays detailed information like the v option; you
41              must be root to do this.
42
43       -t     Tells lsusb to dump the physical USB device hierarchy as a tree.
44
45       -V, --version
46              Print  version information on standard output,  then  exit  suc‐
47              cessfully.
48
49

DIAGNOSTICS

51       cannot open /proc/bus/usb/nnn/nnn, Permission denied (13)
52              To  get  detailed  information,  lsusb  must  open  the files in
53              /proc/bus/usb in read-write mode.  You must be root in order  to
54              do this.
55
56

RETURN VALUE

58       If the specified device is not found, a non-zero exit code is returned.
59
60

FILES

62       /usr/share/usb.ids
63              A  list  of all known USB ID's (vendors, products, classes, sub‐
64              classes and protocols).
65
66       /proc/bus/usb
67              An interface to USB devices provided by  the  post-2.3.15  Linux
68              kernels.  Contains  per-bus subdirectories with per-device files
69              and a devices file displaying some of the descriptors  for  each
70              USB  device.   This  interface is also support by some 2.2 Linux
71              kernels.
72
73

SEE ALSO

75       lspci(8)
76
77

AUTHOR

79       Thomas Sailer, <sailer@ife.ee.ethz.ch>.
80
81
82
83usbutils-0.71                   25 January 2005                       lsusb(8)
Impressum