Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   18644 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

lsusb(8)		      Linux USB Utilities		      lsusb(8)

NAME
       lsusb - list USB devices

SYNOPSIS
       lsusb [ options ]

DESCRIPTION
       lsusb  is  a  utility for displaying information about USB buses in the
       system and the devices connected to them.

       To make use of all the features of this program, you  need  to  have  a
       Linux  kernel  which  supports the /proc/bus/usb interface (e.g., Linux
       kernel 2.3.15 or newer).

OPTIONS
       -v, --verbose
	      Tells lsusb to be verbose and display detailed information about
	      the  devices shown.  This includes configuration descriptors for
	      the device's current speed.  Class descriptors  will  be	shown,
	      when  available,	for  USB  device classes including hub, audio,
	      HID, communications, and chipcard.

       -s [[bus]:][devnum]
	      Show only devices in specified bus and/or devnum.	 Both ID's are
	      given in decimal and may be omitted.

       -d [vendor]:[product]
	      Show  only  devices  with	 the  specified vendor and product ID.
	      Both ID's are given in hexadecimal.

       -D device
	      Do not scan the /proc/bus/usb directory,	instead	 display  only
	      information  about  the  device whose device file is given.  The
	      device file  should  be  something  like	/proc/bus/usb/001/001.
	      This option displays detailed information like the v option; you
	      must be root to do this.

       -t     Tells lsusb to dump the physical USB device hierarchy as a tree.

       -V, --version
	      Print  version information on standard output,  then  exit  suc‐
	      cessfully.

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

RETURN VALUE
       If the specified device is not found, a non-zero exit code is returned.

FILES
       /usr/share/usb.ids
	      A	 list  of all known USB ID's (vendors, products, classes, sub‐
	      classes and protocols).

       /proc/bus/usb
	      An interface to USB devices provided by  the  post-2.3.15	 Linux
	      kernels.	Contains  per-bus subdirectories with per-device files
	      and a devices file displaying some of the descriptors  for  each
	      USB  device.   This  interface is also support by some 2.2 Linux
	      kernels.

SEE ALSO
       lspci(8)

AUTHOR
       Thomas Sailer, <sailer@ife.ee.ethz.ch>.

usbutils-0.71			25 January 2005			      lsusb(8)

Vote for polarhome