dump_usbdev8

Usage

Overview

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

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.