Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for usbmodules (redhat section 8)

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 path-
       name] [--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 hot-
       plugging if the kernel was configured using usbdevfs.  usbmodules currently requires  usb-
       devfs 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.  usb-
	      modules 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  corre-
	      sponding 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 correspond 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)


All times are GMT -4. The time now is 05:39 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password