| 1 |
.TH pcimodules 8 "@TODAY@" "@VERSION@" "Linux PCI Utilities" |
| 2 |
.IX pcimodules |
| 3 |
.SH NAME |
| 4 |
pcimodules \- List kernel driver modules available for all currently plugged |
| 5 |
in PCI devices |
| 6 |
.SH SYNOPSIS |
| 7 |
.B pcimodules |
| 8 |
.RB [ --class class_id ] |
| 9 |
.RB [ --classmask mask ] |
| 10 |
.RB [ --help ] |
| 11 |
.SH DESCRIPTION |
| 12 |
.B pcimodules |
| 13 |
lists all driver modules for all currently plugged in PCI devices. |
| 14 |
.B pcimodules |
| 15 |
should be run at boot time, and whenever a PCI device is "hot plugged" |
| 16 |
into the system. This can be done by the following Bourne shell syntax: |
| 17 |
.IP |
| 18 |
for module in $(pcimodules) ; do |
| 19 |
.IP |
| 20 |
modprobe -s -k "$module" |
| 21 |
.IP |
| 22 |
done |
| 23 |
.PP |
| 24 |
When a PCI device is removed from the system, the Linux kernel will |
| 25 |
decrement a usage count on PCI driver module. If this count drops |
| 26 |
to zero (i.e., there are no PCI drivers), then the |
| 27 |
.B modprobe -r |
| 28 |
process that is normally configured to run from cron every few minutes |
| 29 |
will eventually remove the unneeded module. |
| 30 |
.PP |
| 31 |
The --class and --classmask arguments can be used to limit the search |
| 32 |
to certain classes of PCI devices. This is useful, for example, to |
| 33 |
generate a list of ethernet card drivers to be loaded when the kernel |
| 34 |
has indicated that it is trying to resolve an unknown network interface. |
| 35 |
.PP |
| 36 |
Modules are listed in the order in which the PCI devices are physically |
| 37 |
arranged so that the computer owner can arrange things like having scsi |
| 38 |
device 0 be on a controller that is not alphabetically the first scsi |
| 39 |
controller. |
| 40 |
.SH OPTIONS |
| 41 |
.TP |
| 42 |
.B --class class --classmask mask |
| 43 |
.PP |
| 44 |
--class and --classmask limit the search to PCI |
| 45 |
cards in particular classes. These arguments are always used together. |
| 46 |
The arguments to --class and --classmask |
| 47 |
can be given as hexadecimal numbers by prefixing a leading "0x". |
| 48 |
Note that the classes used by pcimodules are in "Linux" format, |
| 49 |
meaning the class value that you see with lspci would be shifted |
| 50 |
left eight bits, with the new low eight bits programming interface ID. |
| 51 |
An examples of how to use class and classmask is provided below. |
| 52 |
.B --help, -h |
| 53 |
Print a help message and exit. |
| 54 |
.SH EXAMPLES |
| 55 |
.TP |
| 56 |
pcimodules |
| 57 |
lists all modules corresponding to currently plugged in PCI devices. |
| 58 |
.TP |
| 59 |
pcimodules --class 0x200000 --classmask 0xffff00 |
| 60 |
lists all modules corresponding to currently plugged in ethernet PCI devices. |
| 61 |
.SH FILES |
| 62 |
.TP |
| 63 |
.B /lib/modules/<kernel-version>/modules.pcimap |
| 64 |
This file is automatically generated by |
| 65 |
.B depmod, |
| 66 |
and used by |
| 67 |
.B pcimodules |
| 68 |
to determine which modules correspond to which PCI ID's. |
| 69 |
.TP |
| 70 |
.B /proc/bus/pci |
| 71 |
An interface to PCI bus configuration space provided by the post-2.1.82 Linux |
| 72 |
kernels. Contains per-bus subdirectories with per-card config space files and a |
| 73 |
.I devices |
| 74 |
file containing a list of all PCI devices. |
| 75 |
|
| 76 |
.SH SEE ALSO |
| 77 |
.BR lspci (8) |
| 78 |
|
| 79 |
.SH MAINTAINER |
| 80 |
The Linux PCI Utilities are maintained by Martin Mares <[email protected]>. |
| 81 |
|
| 82 |
.SH AUTHOR |
| 83 |
.B pcimodules |
| 84 |
was written by Adam J. Richter <[email protected]>, based on public |
| 85 |
domain example code by Martin Mares <[email protected]>. |
| 86 |
|
| 87 |
.SH COPYRIGHT |
| 88 |
.B pcimodules |
| 89 |
is copyright 2000, Yggdrasil Computing, Incorporated, and may |
| 90 |
be copied under the terms and conditions of version 2 of the GNU |
| 91 |
General Public License as published by the Free Software Foundation |
| 92 |
(Cambrige, Massachusetts, United States of America). |