Debian Codegraph @

upstream/debian-unstable/man1/usb-devices.1

raw
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]>