Manpages

NAME

dump_usbdev − Dumps connected USB devices information

SYNTAX

dump_usbdev [−Vvds] [file]

DESCRIPTION

The utility dump_usbdev aids you in writing usbmgr.conf. After usbmgr has been started, running dump_usbdev will dump infomation about all attached devices in a format suitable for usbmgr.conf.

If you connect USB devices to your USB HUB, you’ll see a line like the following:

−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−
class 0x9 subclass 0x0 protocol 0x0 module <module_name>
−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−
This line will help you writing your /etc/usbmgr/usbmgr.conf configuration file.

OPTIONS

−V

Prints version. It DOES NOT exit.

−v

Verbose mode.

−d

Debug mode. Prints device data details.

−s

Print simply the device numbers, not the entire configuration file text.

file

Specify alternate file to read data from, instead of the default /proc/bus/usb/001/*. If it’s not an absolute path, take as /proc/bugs/usb/001/file. The file format is a series of register of type usb_device_descriptor.

FILES

/proc/bus/usb/001/*

ENVIRONMENT VARIABLES

None.

EXAMPLES

To run this program the standard way type:

dump_usbdev

If you want to debug its output, you can create an appropriate file as myfile and call it:

dump_usdev /path/to/myfile

In the following output:

−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−
class 0x9 subclass 0x0 protocol 0x0 module <module_name>
−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−

"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.

After a USB mouse has been connected to the HUB, running dump_usbdev will give you the following:

−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−
class 0x9 subclass 0x0 protocol 0x0 module <module_name>
vendor 0x56e product 0x4 module <module_name>
−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−

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".

So the complete usbmgr.conf would look like this:

−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−
class 0x9 subclass 0x0 protocol 0x0 module none
vendor 0x56e product 0x4 module hid , mousedev
−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−

You should copy this into /etc/usbmgr/usbmgr.conf, and then run update_usbdb to create the configuration data.

AUTHORS

Shuu Yamaguchi <shuu [AT] wondernetworkresources.com>

This manual page was written by Esteban Manchado Velázquez <zoso [AT] debian.org>, for the Debian GNU/Linux system (but may be used by others).

SEE ALSO

usbmgr(8), update_usbdb(8), usbmgr.conf(5)