File: dump_usbdev.8

package info (click to toggle)
usbmgr 1.0.0-5
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 460 kB
  • ctags: 323
  • sloc: ansic: 2,118; sh: 545; makefile: 154
file content (115 lines) | stat: -rw-r--r-- 3,814 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
.TH "dump_usbdev" "8" "0.4.8" "Shuu Yamaguchi" "USB Utilities"
.SH "NAME"
.LP 
dump_usbdev \- Dumps connected USB devices information
.SH "SYNTAX"
.LP 
dump_usbdev [\-Vvds] [\fIfile\fP]
.SH "DESCRIPTION"
.LP 
The utility \fBdump_usbdev\fP aids you in writing
\fIusbmgr.conf\fP. After \fBusbmgr\fP has been started,
running \fBdump_usbdev\fP will dump infomation about all
attached devices in a format suitable for
\fIusbmgr.conf\fP.
.LP 
If you connect USB devices to your USB HUB, you'll see a line
like the following:
.LP 
.nf 
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
class 0x9 subclass 0x0 protocol 0x0 module <module_name>
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.fi 
This line will help you writing your
\fI/etc/usbmgr/usbmgr.conf\fP configuration file.
.SH "OPTIONS"
.LP 
.TP 
\fB\-V\fR
Prints version. It \fBDOES NOT\fP exit.
.TP 
\fB\-v\fR
Verbose mode.
.TP 
\fB\-d\fR
Debug mode. Prints device data details.
.TP 
\fB\-s\fR
Print simply the device numbers, not the entire configuration
file text.
.TP 
\fIfile\fR
Specify alternate file to read data from, instead of the default
\fI/proc/bus/usb/001/*\fP. If it's not an absolute path,
take as \fI/proc/bugs/usb/001/file\fP. The file format is a
series of register of type \fBusb_device_descriptor\fP.
.SH "FILES"
.LP 
\fI/proc/bus/usb/001/*\fP 
.SH "ENVIRONMENT VARIABLES"
.LP 
None.
.SH "EXAMPLES"
.LP 
To run this program the standard way type:
.LP 
dump_usbdev
.LP 
If you want to debug its output, you can create an appropriate
file as \fImyfile\fP and call it:
.LP 
dump_usdev /path/to/myfile
.LP 
In the following output:
.LP 
.nf 
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
class 0x9 subclass 0x0 protocol 0x0 module <module_name>
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.fi 
.LP 
"class 0x9" means USB HUB. If no USB devices are connected,
only the root HUB will appear. Modifying "<module_name>"
would complete the configuration for this device (HUB).
In the case of a HUB, you should change "module_name" to "none"
because the HUB driver is included in usbcore.
.LP 
After a USB mouse has been connected to the HUB, running 
\fBdump_usbdev\fP will give you the following:
.LP 
.nf 
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
class 0x9 subclass 0x0 protocol 0x0 module <module_name>
vendor 0x56e product 0x4 module <module_name>
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.fi 
.LP 
The 2nd line is new. This is the infomation about the USB 
mouse. The USB mouse requires the "hid" and "mousedev" drivers.
So, "<module>" should be changed to "hid , mousedev".
.LP 
So the complete \fIusbmgr.conf\fP would look like this:
.LP 
.nf 
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
class 0x9 subclass 0x0 protocol 0x0 module none
vendor 0x56e product 0x4 module hid , mousedev
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.fi 
.LP 
You should copy this into \fI/etc/usbmgr/usbmgr.conf\fP,
and then run \fBupdate_usbdb\fP to create the configuration
data.
.SH "AUTHORS"
.LP 
Shuu Yamaguchi <shuu@wondernetworkresources.com>
.LP 
This manual page was written by Esteban Manchado Vel\['a]zquez
<zoso@debian.org>, for the Debian GNU/Linux system (but may be
used by others).
.SH "SEE ALSO"
.LP 
.BR usbmgr (8),
.BR update_usbdb (8),
.BR usbmgr.conf (5)