usbmodules(8) Linux USB Utilities usbmodules(8)
NAME
usbmodules - List kernel driver modules available for a plugged in USB device
SYNOPSIS
usbmodules [--device /proc/bus/bus/NNN/NNN] [--check modulename] [--help] [--mapfile pathname] [--version pathname]
DESCRIPTION
usbmodules lists driver modules that may be able to manage interfaces on currently plugged in USB devices. usbmodules may be used by
/sbin/hotplug or one of its agents (normally /etc/hotplug/usb.agent) when USB devices are "hot plugged" into the system. This can be done
by the following Bourne shell syntax:
for module in $(usbmodules --device $DEVICE) ; do
modprobe -s -k "$module"
done
The DEVICE environment variable is passed from the kernel to /sbin/hotplug during USB hotplugging if the kernel was configured using usbde-
vfs. usbmodules currently requires usbdevfs to operate.
When a USB device is removed from the system, the Linux kernel will decrement a usage count on USB driver module. If this count drops to
zero (i.e., there are no clients for the USB device driver), then the modprobe -r process that is normally configured to run from cron
every few minutes will eventually remove the unneeded module.
OPTIONS
--check modulename
Instead of listing the relevant modules, just exit with code 0 (success) if the given module's exported USB ID patterns matches.
Otherwise, return failure. usbmodules emits no output either way.
--device /proc/bus/usb/MMM/NNN
Selects which device usbmodules will examine. The argument is currently mandatory.
--help, -h
Print a help message
--mapfile /etc/hotplug/usb.handmap
Use the specified file instead of the /lib/modules/.../modules.usbmap file corresponding to the running kernel.
--version
Identifies the version of usbutils this tool was built with.
FILES
/lib/modules/<kernel-version>/modules.usbmap
This file is automatically generated by depmod, versions 2.4.2 and later, and is used by usbmodules to determine which modules cor-
respond to which USB ID's.
/proc/bus/usb
An optional interface to USB devices provided by Linux kernels with versions of the 2.4 USB support. Contains per-bus subdirectories
with per-device files (offering a usermode driver API as well as access to device and configuration descriptors), a devices file
containing a list of all USB devices, and a drivers file listing USB device drivers known to the USB subsystem.
SEE ALSO
lsusb(8), http://linux-hotplug.sourceforge.net
AUTHOR
usbmodules was written by Adam J. Richter <adam@yggdrasil.com>, and is based partly on lsusb, which was written by Thomas Sailer
<sailer@ife.ee.ethz.ch>.
COPYRIGHT
usbmodules is copyright 2000, Yggdrasil Computing, Incorporated, and copyright 1999, Thomas Sailer. usbmodules may may be copied under the
terms and conditions of version 2 of the GNU General Public License as published by the Free Software Foundation (Cambrige, Massachusetts,
United States of America).
usbutils-0.8 12 June 2001 usbmodules(8)
