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

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

grepmap [OPTION]... --udev

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.

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.

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.

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.

Written by Scott James Remnant.

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

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.

depmod(8) udev(8)