| .TH usb-devices 1 "23 June 2009" "usbutils-VERSION" "Linux USB Utilities" |
| .IX usb-devices |
| .SH NAME |
| usb-devices \- print USB device details |
| .SH SYNOPSIS |
| .B usb-devices |
| |
| .SH DESCRIPTION |
| .B usb-devices |
| is a (bash) shell script that can be used to display details of USB |
| buses in the system and the devices connected to them. |
| |
| The output of the script is similar to the \fIusb/devices\fP file |
| available either under \fI/proc/bus\fP (if usbfs is mounted), or under |
| \fI/sys/kernel/debug\fP (if debugfs is mounted there). The script is |
| primairily intended to be used if the file is not available. |
| |
| In contrast to the \fIusb/devices\fP file, this script only lists |
| \fIactive\fP interfaces (those marked with a "*" in the \fIusb/devices\fP |
| file) and their endpoints. |
| |
| Be advised that there can be differences in the way information is sorted, |
| as well as in the format of the output. |
| |
| .SH RETURN VALUE |
| If sysfs is not mounted, a non-zero exit code is returned. |
| |
| .SH FILES |
| .TP |
| .B /sys/bus/usb/devices/usb* |
| The part of the sysfs tree the script walks through to assemble the |
| printed information. |
| .TP |
| .B /proc/bus/usb/devices |
| Location where the \fIusb/devices\fP file can normally be found for |
| Linux kernels before 2.6.31, if usbfs is mounted. |
| .TP |
| .B /sys/kernel/debug/usb/devices |
| Location where the \fIusb/devices\fP file can normally be found for |
| Linux kernel 2.6.31 and later, if debugfs is mounted. |
| |
| .SH SEE ALSO |
| .BR lsusb (8), |
| .BR usbview (8). |
| |
| .SH AUTHORS |
| Greg Kroah-Hartman <greg@kroah.com> |
| .P |
| Randy Dunlap <rdunlap@xenotime.net> |
| .P |
| Frans Pop <elendil@planet.nl> |
