| 1 |
.\" SPDX-License-Identifier: GPL-2.0-only |
| 2 |
.\" Copyright (c) 2004 Greg Kroah-Hartman <[email protected]> |
| 3 |
.\" Copyright (c) 2004 Randy Dunlap <[email protected]> |
| 4 |
.\" Copyright (c) 2004 Frans Pop <[email protected]> |
| 5 |
.TH usb-devices 1 "23 June 2009" "usbutils" "Linux USB Utilities" |
| 6 |
.IX usb-devices |
| 7 |
.SH NAME |
| 8 |
usb-devices \- print USB device details |
| 9 |
.SH SYNOPSIS |
| 10 |
.B usb-devices |
| 11 |
|
| 12 |
.SH DESCRIPTION |
| 13 |
.B usb-devices |
| 14 |
is a shell script that can be used to display details of USB |
| 15 |
buses in the system and the devices connected to them. |
| 16 |
|
| 17 |
The output of the script is similar to the \fIusb/devices\fP file |
| 18 |
available either under \fI/proc/bus\fP (if usbfs is mounted), or under |
| 19 |
\fI/sys/kernel/debug\fP (if debugfs is mounted there). The script is |
| 20 |
primarily intended to be used if the file is not available. |
| 21 |
|
| 22 |
In contrast to the \fIusb/devices\fP file, this script only lists |
| 23 |
\fIactive\fP interfaces (those marked with a "*" in the \fIusb/devices\fP |
| 24 |
file) and their endpoints. |
| 25 |
|
| 26 |
Be advised that there can be differences in the way information is sorted, |
| 27 |
as well as in the format of the output. |
| 28 |
|
| 29 |
.SH RETURN VALUE |
| 30 |
If sysfs is not mounted, a non-zero exit code is returned. |
| 31 |
|
| 32 |
.SH FILES |
| 33 |
.TP |
| 34 |
.B /sys/bus/usb/devices/usb* |
| 35 |
The part of the sysfs tree the script walks through to assemble the |
| 36 |
printed information. |
| 37 |
.TP |
| 38 |
.B /proc/bus/usb/devices |
| 39 |
Location where the \fIusb/devices\fP file can normally be found for |
| 40 |
Linux kernels before 2.6.31, if usbfs is mounted. |
| 41 |
.TP |
| 42 |
.B /sys/kernel/debug/usb/devices |
| 43 |
Location where the \fIusb/devices\fP file can normally be found for |
| 44 |
Linux kernel 2.6.31 and later, if debugfs is mounted. |
| 45 |
|
| 46 |
.SH SEE ALSO |
| 47 |
.BR lsusb (8), |
| 48 |
.BR usbview (8). |
| 49 |
|
| 50 |
.SH AUTHORS |
| 51 |
Greg Kroah-Hartman <[email protected]> |
| 52 |
.P |
| 53 |
Randy Dunlap <[email protected]> |
| 54 |
.P |
| 55 |
Frans Pop <[email protected]> |