usb-devices.1.in

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