Provided by: grepmap_1.1.0-1_i386 bug

NAME

       grepmap - parse module map files produced by module-init-tools

SYNOPSIS

       grepmap [OPTION]... MAPTYPE ARG...

       grepmap [OPTION]... --udev

DESCRIPTION

       Parses  the  module  map  files  produced by the depmod(8) command from
       module-init-tools and outputs the list of modules you should  load  for
       the  device  information  given  on  the  command  line or found in the
       environment of a udev event.

OPTIONS

       Mandatory arguments to long options are  mandatory  for  short  options
       too.

       -k, --kernel=VERSION
              Read  map  files  from alternative kernel VERSION instead of the
              current one.  Ignored when --file is used.

       -f, --file=FILE
              Read the map file FILE instead of one for any particular  kernel
              version.  If file is ‘-’ standard input is read.  Care should be
              taken to ensure this  file  is  in  the  same  format  as  those
              produced by depmod(8)

       --udev Read  device  information  from  the environment of a udev event
              recieved from the kernel.  This is is usually  used  in  a  udev
              rule such as:

              SUBSYSTEM=="input", PROGRAM="/sbin/grepmap --udev", \
                      RUN+="/sbin/modprobe $result"

              The  map  file  to  read  is  found  by  reading  the  SUBSYSTEM
              environment variable therefore this option  cannot  be  combined
              with one of the map type options.

       --help Display help and exit.

       --version
              Display version information and exit.

MAP TYPES

       The  MAPTYPE argument specifies the type of map file to read.  Each one
       has different requirements for the  following  ARG.   Unless  otherwise
       specified   these  arguments  should  be  the  hexadecimal  identifiers
       obtained from the kernel’s sysfs filesystem.  An optional  ‘0x’,  ‘&#x’
       or ‘&’ prefix is permitted.

       -p, --pcimap VENDOR DEVICE SUBSYSTEM-VENDOR SUBSYSTEM-DEVICE CLASS
              Parses a modules.pcimap format file.

       -u,   --usbmap  VENDOR  PRODUCT  VERSION  DEVICE-CLASS  DEVICE-SUBCLASS
       DEVICE-PROTOCOL INTERFACE-CLASS INTERFACE-SUBCLASS INTERFACE-PROTOCOL
              Parses  a modules.usbmap format file.  VERSION much be specified
              without any  period  between  the  high  and  low  parts.   e.g.
              ‘0x0123’ not ‘1.23’

       -i,  --inputmap  BUS  VENDOR PRODUCT VERSION EVBIT KEYBIT RELBIT ABSBIT
       MSCBIT LEDBIT SNDBIT FFBIT
              Parses a modules.inputmap format file.  The BIT arguments should
              be specified as a colon-delimited array of hexadecimal values.

       -w, --ieee1394map VENDOR MODEL SPECIFIER VERSION
              Parses a modules.ieee1394map format file (firewire).

       -c, --ccwmap CU_TYPE CU_MODEL DEV_TYPE DEV_MODEL
              Parses a modules.ccwmap format file.

       -s, --seriomap TYPE EXTRA ID PROTO
              Parses a modules.seriomap format file.

EXIT STATUS

       If a match module is found the exit status will be 0.  If no module was
       found, the exit status will be 1; if any other error occurred, the exit
       status will be 2.

AUTHOR

       Written by Scott James Remnant.

REPORTING BUGS

       Report bugs to <ubuntu-devel@lists.ubuntu.com>.

COPYRIGHT

       Copyright © 2005 Canonical Ltd.
       This is free software; see the source for copying conditions.  There is
       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
       PURPOSE.

SEE ALSO

       depmod(8) udev(8)