lsusb.8.in

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