usbmodules(8) [redhat man page]

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)

usbmodules_selinux(8)					     SELinux Policy usbmodules					     usbmodules_selinux(8)

NAME

       usbmodules_selinux - Security Enhanced Linux Policy for the usbmodules processes

DESCRIPTION

       Security-Enhanced Linux secures the usbmodules processes via flexible mandatory access control.

       The  usbmodules processes execute with the usbmodules_t SELinux type. You can check if you have these processes running by executing the ps
       command with the -Z qualifier.

       For example:

       ps -eZ | grep usbmodules_t

ENTRYPOINTS

       The usbmodules_t SELinux type can be entered via the usbmodules_exec_t file type.

       The default entrypoint paths for the usbmodules_t domain are the following:

       /sbin/usbmodules, /usr/sbin/usbmodules

PROCESS TYPES

       SELinux defines process types (domains) for each process running on the system

       You can see the context of a process using the -Z option to ps

       Policy governs the access confined processes have to files.  SELinux usbmodules policy is very flexible allowing users to setup their  usb-
       modules processes in as secure a method as possible.

       The following process types are defined for usbmodules:

       usbmodules_t

       Note:  semanage	permissive  -a	usbmodules_t can be used to make the process type usbmodules_t permissive. SELinux does not deny access to
       permissive process types, but the AVC (SELinux denials) messages are still generated.

BOOLEANS

       SELinux policy is customizable based on least access required.  usbmodules policy is extremely flexible and has several booleans that allow
       you to manipulate the policy and run usbmodules with the tightest access possible.

       If you want to allow all daemons the ability to read/write terminals, you must turn on the daemons_use_tty boolean. Disabled by default.

       setsebool -P daemons_use_tty 1

       If  you	want  to  deny	any  process  from ptracing or debugging any other processes, you must turn on the deny_ptrace boolean. Enabled by
       default.

       setsebool -P deny_ptrace 1

       If you want to allow all domains to use other domains file descriptors, you must turn on the domain_fd_use boolean. Enabled by default.

       setsebool -P domain_fd_use 1

       If you want to allow all domains to have the kernel load modules, you must turn on  the	domain_kernel_load_modules  boolean.  Disabled	by
       default.

       setsebool -P domain_kernel_load_modules 1

       If you want to allow all domains to execute in fips_mode, you must turn on the fips_mode boolean. Enabled by default.

       setsebool -P fips_mode 1

       If you want to enable reading of urandom for all domains, you must turn on the global_ssp boolean. Disabled by default.

       setsebool -P global_ssp 1

MANAGED FILES

       The  SELinux  process type usbmodules_t can manage files labeled with the following file types.	The paths listed are the default paths for
       these file types.  Note the processes UID still need to have DAC permissions.

       usbfs_t

FILE CONTEXTS

       SELinux requires files to have an extended attribute to define the file type.

       You can see the context of a file using the -Z option to ls

       Policy governs the access confined processes have to these files.  SELinux usbmodules policy is very flexible allowing users to setup their
       usbmodules processes in as secure a method as possible.

       STANDARD FILE CONTEXT

       SELinux	defines  the  file context types for the usbmodules, if you wanted to store files with these types in a diffent paths, you need to
       execute the semanage command to sepecify alternate labeling and then use restorecon to put the labels on disk.

       semanage fcontext -a -t usbmodules_exec_t '/srv/usbmodules/content(/.*)?'
       restorecon -R -v /srv/myusbmodules_content

       Note: SELinux often uses regular expressions to specify labels that match multiple files.

       The following file types are defined for usbmodules:

       usbmodules_exec_t

       - Set files with the usbmodules_exec_t type, if you want to transition an executable to the usbmodules_t domain.

       Paths:
	    /sbin/usbmodules, /usr/sbin/usbmodules

       Note: File context can be temporarily modified with the chcon command.  If you want to permanently change the file context you need to  use
       the semanage fcontext command.  This will modify the SELinux labeling database.	You will need to use restorecon to apply the labels.

COMMANDS

       semanage fcontext can also be used to manipulate default file context mappings.

       semanage permissive can also be used to manipulate whether or not a process type is permissive.

       semanage module can also be used to enable/disable/install/remove policy modules.

       semanage boolean can also be used to manipulate the booleans

       system-config-selinux is a GUI tool available to customize SELinux policy settings.

AUTHOR

       This manual page was auto-generated using sepolicy manpage .

SEE ALSO

       selinux(8), usbmodules(8), semanage(8), restorecon(8), chcon(1), sepolicy(8) , setsebool(8)

usbmodules							     14-06-10						     usbmodules_selinux(8)