LinuxGuide.it > Linux Man Page: "lsusb"

 
 
Search with Google

 

The Linux Documentation Project maintains an archive of snaphots of the (English language) core Linux manual pages that are maintained by Michael Kerrisk. Corrections and additions are welcome, but review the "Help Wanted" list, first.

Man pages belonging to programs are usually distributed together with those programs. Therefore, the core Linux man-pages mainly contains the pages for system calls and library routines, special devices, and file formats. However, it also contains documentation for a few programs, in cases where the authors or maintainers of the program do not distribute man pages themselves.

This page is part of release 3.11 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages

 
man page(1) manual page Table of Contents

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 successfully.

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, subclasses 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>.

Table of Contents
use open software!