pciutils/patches/pcimodules-pciutils-2.2.0.patch

--- pciutils-2.2.0/lspci.c
+++ pciutils-dsd/lspci.c
@@ -113,8 +113,10 @@ scan_device(struct pci_dev *p)
   d->config = xmalloc(64);
   d->present = xmalloc(64);
   memset(d->present, 1, 64);
-  if (!pci_read_block(p, 0, d->config, 64))
-    die("Unable to read the standard configuration space header");
+  if (!pci_read_block(p, 0, d->config, 64)) {
+    fprintf(stderr, "Unable to read the standard configuration space header");
+	return NULL;
+  }
   if ((d->config[PCI_HEADER_TYPE] & 0x7f) == PCI_HEADER_TYPE_CARDBUS)
     {
       /* For cardbus bridges, we need to fetch 64 bytes more to get the
--- pciutils-2.2.0/Makefile
+++ pciutils-dsd/Makefile
@@ -33,7 +33,7 @@ RELEASE=
 
 export
 
-all: $(PCILIB) lspci setpci lspci.8 setpci.8 update-pciids update-pciids.8 pci.ids
+all: $(PCILIB) lspci setpci pcimodules lspci.8 setpci.8 update-pciids update-pciids.8 pcimodules.8 pci.ids
 
 $(PCILIB): $(PCIINC) force
 	$(MAKE) -C lib all
@@ -43,9 +43,11 @@ force:
 lib/config.h:
 	cd lib && ./configure $(IDSDIR) $(VERSION) $(HOST) $(RELEASE)
 
+pcimodules: pcimodules.o common.o $(PCILIB)
 lspci: lspci.o common.o $(PCILIB)
 setpci: setpci.o common.o $(PCILIB)
 
+pcimodules.o: pcimodules.c pciutils.h $(PCIINC)
 lspci.o: lspci.c pciutils.h $(PCIINC)
 setpci.o: setpci.c pciutils.h $(PCIINC)
 common.o: common.c pciutils.h $(PCIINC)
@@ -66,15 +68,15 @@ distclean: clean
 install: all
 # -c is ignored on Linux, but required on FreeBSD
 	$(DIRINSTALL) -m 755 $(SBINDIR) $(IDSDIR) $(MANDIR)/man8
-	$(INSTALL) -c -m 755 -s lspci setpci $(SBINDIR)
+	$(INSTALL) -c -m 755 -s lspci setpci pcimodules $(SBINDIR)
 	$(INSTALL) -c -m 755 update-pciids $(SBINDIR)
 	$(INSTALL) -c -m 644 pci.ids $(IDSDIR)
-	$(INSTALL) -c -m 644 lspci.8 setpci.8 update-pciids.8 $(MANDIR)/man8
+	$(INSTALL) -c -m 644 lspci.8 setpci.8 update-pciids.8 pcimodules.8 $(MANDIR)/man8
 
 uninstall: all
-	rm -f $(SBINDIR)/lspci $(SBINDIR)/setpci $(SBINDIR)/update-pciids
+	rm -f $(SBINDIR)/lspci $(SBINDIR)/setpci $(SBINDIR)/update-pciids $(SBINDIR)/pcimodules
 	rm -f $(IDSDIR)/pci.ids
-	rm -f $(MANDIR)/man8/lspci.8 $(MANDIR)/man8/setpci.8 $(MANDIR)/man8/update-pciids.8
+	rm -f $(MANDIR)/man8/lspci.8 $(MANDIR)/man8/setpci.8 $(MANDIR)/man8/update-pciids.8 $(MANDIR)/man8/pcimodules.8
 
 get-ids:
 	cp ~/tree/pciids/pci.ids pci.ids
--- pciutils-2.2.0/pcimodules.c
+++ pciutils-dsd/pcimodules.c
@@ -0,0 +1,183 @@
+/*
+ *	pcimodules:  Load all kernel modules for PCI device currently
+ *      plugged into any PCI slot.
+ *
+ *	Copyright 2000 Yggdrasil Computing, Incorporated
+ *	This file may be copied under the terms and conditions of version 
+ *      two of the GNU General Public License, as published by the Free
+ *      Software Foundation (Cambridge, Massachusetts, USA).
+ *
+ *      This file is based on pciutils/lib/example.c, which has the following
+ *      authorship and copyright statement:
+ *
+ *		Written by Martin Mares and put to public domain. You can do
+ *		with it anything you want, but I don't give you any warranty.
+ */
+
+#include <stdlib.h>
+#include <stdio.h>
+#include <malloc.h>
+#include <string.h>
+#include <unistd.h>
+#include <sys/utsname.h>
+#include <sys/param.h>
+#include <sys/types.h>
+
+#define _GNU_SOURCE
+#include <getopt.h>
+
+#include "pciutils.h"
+
+#define MODDIR	"/lib/modules"
+#define PCIMAP	"modules.pcimap"
+
+#define LINELENGTH	8000 
+
+#define DEVICE_ANY	0xffffffff
+#define VENDOR_ANY	0xffffffff
+
+#include "lib/pci.h"
+
+struct pcimap_entry {
+	unsigned int vendor, subsys_vendor, dev, subsys_dev, class, class_mask;
+	char *module;
+	struct pcimap_entry *next;
+};
+
+static struct pcimap_entry *pcimap_list = NULL;
+
+#define OPT_STRING "h"
+static struct option long_options[] = {
+	{"class",	required_argument,	NULL, 'c'},
+	{"classmask",	required_argument,	NULL, 'm'},
+	{"help",	no_argument,		NULL, 'h'},
+	{ 0,		0,			0, 	0}
+};
+
+static unsigned long desired_class;
+static unsigned long desired_classmask; /* Default is 0: accept all classes.*/
+
+void
+read_pcimap(void)
+{
+	struct utsname utsname;
+	char filename[MAXPATHLEN];
+	FILE *pcimap_file;
+	char line[LINELENGTH];
+	struct pcimap_entry *entry;
+	unsigned int driver_data;
+	char *prevmodule = "";
+	char module[LINELENGTH];
+
+	if (uname(&utsname) < 0) {
+		perror("uname");
+		exit(1);
+	}
+	sprintf(filename, "%s/%s/%s", MODDIR, utsname.release, PCIMAP);
+	if ((pcimap_file = fopen(filename, "r")) == NULL) {
+		perror(filename);
+		exit(1);
+	}
+
+	while(fgets(line, LINELENGTH, pcimap_file) != NULL) {
+		if (line[0] == '#')
+			continue;
+
+		entry = xmalloc(sizeof(struct pcimap_entry));
+
+		if (sscanf(line, "%s 0x%x 0x%x 0x%x 0x%x 0x%x 0x%x 0x%x",
+			   module,
+			   &entry->vendor, &entry->dev,
+			   &entry->subsys_vendor, &entry->subsys_dev,
+			   &entry->class, &entry->class_mask,
+			   &driver_data) != 8) {
+			fprintf (stderr,
+				"modules.pcimap unparsable line: %s.\n", line);
+			free(entry);
+			continue;
+		}
+
+		/* Optimize memory allocation a bit, in case someday we
+		   have Linux systems with ~100,000 modules.  It also
+		   allows us to just compare pointers to avoid trying
+		   to load a module twice. */
+		if (strcmp(module, prevmodule) != 0) {
+			prevmodule = xmalloc(strlen(module)+1);
+			strcpy(prevmodule, module);
+		}
+		entry->module = prevmodule;
+		entry->next = pcimap_list;
+		pcimap_list = entry;
+	}
+	fclose(pcimap_file);
+}
+
+/* Return a filled in pci_access->dev tree, with the device classes
+   stored in dev->aux.
+*/
+static void
+match_pci_modules(void)
+{
+	struct pci_access *pacc;
+	struct pci_dev *dev;
+	unsigned int class, subsys_dev, subsys_vendor;
+	struct pcimap_entry *map;
+	const char *prevmodule = "";
+
+	pacc = pci_alloc();		/* Get the pci_access structure */
+	/* Set all options you want -- here we stick with the defaults */
+	pci_init(pacc);		/* Initialize the PCI library */
+	pci_scan_bus(pacc);	/* We want to get the list of devices */
+  	for(dev=pacc->devices; dev; dev=dev->next) {
+		pci_fill_info(dev, PCI_FILL_IDENT | PCI_FILL_BASES);
+		class = (pci_read_word(dev, PCI_CLASS_DEVICE) << 8)
+			| pci_read_byte(dev, PCI_CLASS_PROG);
+		subsys_dev = pci_read_word(dev, PCI_SUBSYSTEM_ID);
+		subsys_vendor = pci_read_word(dev,PCI_SUBSYSTEM_VENDOR_ID);
+		for(map = pcimap_list; map != NULL; map = map->next) {
+			if (((map->class ^ class) & map->class_mask) == 0 &&
+			    ((desired_class ^ class) & desired_classmask)==0 &&
+			    (map->dev == DEVICE_ANY ||
+			     map->dev == dev->device_id) &&
+			    (map->vendor == VENDOR_ANY ||
+			     map->vendor == dev->vendor_id) &&
+			    (map->subsys_dev == DEVICE_ANY ||
+			     map->subsys_dev == subsys_dev) &&
+			    (map->subsys_vendor == VENDOR_ANY ||
+			     map->subsys_vendor == subsys_vendor) &&
+			    prevmodule != map->module) {
+				printf("%s\n", map->module);
+				prevmodule = map->module;
+			}
+		}
+
+	}
+	pci_cleanup(pacc);
+}
+
+int
+main (int argc, char **argv)
+{
+	int opt_index = 0;
+	int opt;
+
+	while ((opt = getopt_long(argc, argv, OPT_STRING, long_options,
+		           &opt_index)) != -1) {
+		switch(opt) {
+			case 'c':
+				desired_class = strtol(optarg, NULL, 0);
+				break;
+			case 'm':
+				desired_classmask = strtol(optarg, NULL, 0);
+				break;
+			case 'h':
+				printf ("Usage: pcimodules [--help]\n"
+					"  Lists kernel modules corresponding to PCI devices currently plugged"
+					"  into the computer.\n");
+		}
+	}	
+
+	read_pcimap();
+	match_pci_modules();
+	return 0;
+}
--- pciutils-2.2.0/pcimodules.man
+++ pciutils-dsd/pcimodules.man
@@ -0,0 +1,92 @@
+.TH pcimodules 8 "@TODAY@" "@VERSION@" "Linux PCI Utilities"
+.IX pcimodules
+.SH NAME
+pcimodules \- List kernel driver modules available for all currently plugged
+in PCI devices
+.SH SYNOPSIS
+.B pcimodules
+.RB [ --class class_id ]
+.RB [ --classmask mask ]
+.RB [ --help ]
+.SH DESCRIPTION
+.B pcimodules
+lists all driver modules for all currently plugged in PCI devices.
+.B pcimodules
+should be run at boot time, and whenever a PCI device is "hot plugged"
+into the system.  This can be done by the following Bourne shell syntax:
+.IP
+	for module in $(pcimodules) ; do
+.IP
+		modprobe -s -k "$module"
+.IP
+	done
+.PP
+When a PCI device is removed from the system, the Linux kernel will
+decrement a usage count on PCI driver module.  If this count drops
+to zero (i.e., there are no PCI drivers), then the
+.B modprobe -r
+process that is normally configured to run from cron every few minutes
+will eventually remove the unneeded module.
+.PP
+The --class and --classmask arguments can be used to limit the search
+to certain classes of PCI devices.  This is useful, for example, to
+generate a list of ethernet card drivers to be loaded when the kernel
+has indicated that it is trying to resolve an unknown network interface.
+.PP
+Modules are listed in the order in which the PCI devices are physically
+arranged so that the computer owner can arrange things like having scsi
+device 0 be on a controller that is not alphabetically the first scsi
+controller.
+.SH OPTIONS
+.TP
+.B --class class --classmask mask
+.PP
+--class and --classmask limit the search to PCI
+cards in particular classes.  These arguments are always used together.
+The arguments to --class and --classmask
+can be given as hexadecimal numbers by prefixing a leading "0x".
+Note that the classes used by pcimodules are in "Linux" format,
+meaning the class value that you see with lspci would be shifted
+left eight bits, with the new low eight bits programming interface ID.
+An examples of how to use class and classmask is provided below.
+.B --help, -h
+Print a help message and exit.
+.SH EXAMPLES
+.TP
+pcimodules
+lists all modules corresponding to currently plugged in PCI devices.
+.TP
+pcimodules --class 0x200000 --classmask 0xffff00
+lists all modules corresponding to currently plugged in ethernet PCI devices.
+.SH FILES
+.TP
+.B /lib/modules/<kernel-version>/modules.pcimap
+This file is automatically generated by
+.B depmod,
+and used by
+.B pcimodules
+to determine which modules correspond to which PCI ID's.
+.TP
+.B /proc/bus/pci
+An interface to PCI bus configuration space provided by the post-2.1.82 Linux
+kernels. Contains per-bus subdirectories with per-card config space files and a
+.I devices
+file containing a list of all PCI devices.
+
+.SH SEE ALSO
+.BR lspci (8)
+
+.SH MAINTAINER
+The Linux PCI Utilities are maintained by Martin Mares <mj@suse.cz>.
+
+.SH AUTHOR
+.B pcimodules
+was written by Adam J. Richter <adam@yggdrasil.com>, based on public
+domain example code by Martin Mares <mj@suse.cz>.
+
+.SH COPYRIGHT
+.B pcimodules
+is copyright 2000, Yggdrasil Computing, Incorporated, and 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).
1	niro	153	--- pciutils-2.2.0/lspci.c
2			+++ pciutils-dsd/lspci.c
3			@@ -113,8 +113,10 @@ scan_device(struct pci_dev *p)
4			d->config = xmalloc(64);
5			d->present = xmalloc(64);
6			memset(d->present, 1, 64);
7			- if (!pci_read_block(p, 0, d->config, 64))
8			- die("Unable to read the standard configuration space header");
9			+ if (!pci_read_block(p, 0, d->config, 64)) {
10			+ fprintf(stderr, "Unable to read the standard configuration space header");
11			+ return NULL;
12			+ }
13			if ((d->config[PCI_HEADER_TYPE] & 0x7f) == PCI_HEADER_TYPE_CARDBUS)
14			{
15			/* For cardbus bridges, we need to fetch 64 bytes more to get the
16			--- pciutils-2.2.0/Makefile
17			+++ pciutils-dsd/Makefile
18			@@ -33,7 +33,7 @@ RELEASE=
19
20			export
21
22			-all: $(PCILIB) lspci setpci lspci.8 setpci.8 update-pciids update-pciids.8 pci.ids
23			+all: $(PCILIB) lspci setpci pcimodules lspci.8 setpci.8 update-pciids update-pciids.8 pcimodules.8 pci.ids
24
25			$(PCILIB): $(PCIINC) force
26			$(MAKE) -C lib all
27			@@ -43,9 +43,11 @@ force:
28			lib/config.h:
29			cd lib && ./configure $(IDSDIR) $(VERSION) $(HOST) $(RELEASE)
30
31			+pcimodules: pcimodules.o common.o $(PCILIB)
32			lspci: lspci.o common.o $(PCILIB)
33			setpci: setpci.o common.o $(PCILIB)
34
35			+pcimodules.o: pcimodules.c pciutils.h $(PCIINC)
36			lspci.o: lspci.c pciutils.h $(PCIINC)
37			setpci.o: setpci.c pciutils.h $(PCIINC)
38			common.o: common.c pciutils.h $(PCIINC)
39			@@ -66,15 +68,15 @@ distclean: clean
40			install: all
41			# -c is ignored on Linux, but required on FreeBSD
42			$(DIRINSTALL) -m 755 $(SBINDIR) $(IDSDIR) $(MANDIR)/man8
43			- $(INSTALL) -c -m 755 -s lspci setpci $(SBINDIR)
44			+ $(INSTALL) -c -m 755 -s lspci setpci pcimodules $(SBINDIR)
45			$(INSTALL) -c -m 755 update-pciids $(SBINDIR)
46			$(INSTALL) -c -m 644 pci.ids $(IDSDIR)
47			- $(INSTALL) -c -m 644 lspci.8 setpci.8 update-pciids.8 $(MANDIR)/man8
48			+ $(INSTALL) -c -m 644 lspci.8 setpci.8 update-pciids.8 pcimodules.8 $(MANDIR)/man8
49
50			uninstall: all
51			- rm -f $(SBINDIR)/lspci $(SBINDIR)/setpci $(SBINDIR)/update-pciids
52			+ rm -f $(SBINDIR)/lspci $(SBINDIR)/setpci $(SBINDIR)/update-pciids $(SBINDIR)/pcimodules
53			rm -f $(IDSDIR)/pci.ids
54			- rm -f $(MANDIR)/man8/lspci.8 $(MANDIR)/man8/setpci.8 $(MANDIR)/man8/update-pciids.8
55			+ rm -f $(MANDIR)/man8/lspci.8 $(MANDIR)/man8/setpci.8 $(MANDIR)/man8/update-pciids.8 $(MANDIR)/man8/pcimodules.8
56
57			get-ids:
58			cp ~/tree/pciids/pci.ids pci.ids
59			--- pciutils-2.2.0/pcimodules.c
60			+++ pciutils-dsd/pcimodules.c
61			@@ -0,0 +1,183 @@
62			+/*
63			+ * pcimodules: Load all kernel modules for PCI device currently
64			+ * plugged into any PCI slot.
65			+ *
66			+ * Copyright 2000 Yggdrasil Computing, Incorporated
67			+ * This file may be copied under the terms and conditions of version
68			+ * two of the GNU General Public License, as published by the Free
69			+ * Software Foundation (Cambridge, Massachusetts, USA).
70			+ *
71			+ * This file is based on pciutils/lib/example.c, which has the following
72			+ * authorship and copyright statement:
73			+ *
74			+ * Written by Martin Mares and put to public domain. You can do
75			+ * with it anything you want, but I don't give you any warranty.
76			+ */
77			+
78			+#include <stdlib.h>
79			+#include <stdio.h>
80			+#include <malloc.h>
81			+#include <string.h>
82			+#include <unistd.h>
83			+#include <sys/utsname.h>
84			+#include <sys/param.h>
85			+#include <sys/types.h>
86			+
87			+#define _GNU_SOURCE
88			+#include <getopt.h>
89			+
90			+#include "pciutils.h"
91			+
92			+#define MODDIR "/lib/modules"
93			+#define PCIMAP "modules.pcimap"
94			+
95			+#define LINELENGTH 8000
96			+
97			+#define DEVICE_ANY 0xffffffff
98			+#define VENDOR_ANY 0xffffffff
99			+
100			+#include "lib/pci.h"
101			+
102			+struct pcimap_entry {
103			+ unsigned int vendor, subsys_vendor, dev, subsys_dev, class, class_mask;
104			+ char *module;
105			+ struct pcimap_entry *next;
106			+};
107			+
108			+static struct pcimap_entry *pcimap_list = NULL;
109			+
110			+#define OPT_STRING "h"
111			+static struct option long_options[] = {
112			+ {"class", required_argument, NULL, 'c'},
113			+ {"classmask", required_argument, NULL, 'm'},
114			+ {"help", no_argument, NULL, 'h'},
115			+ { 0, 0, 0, 0}
116			+};
117			+
118			+static unsigned long desired_class;
119			+static unsigned long desired_classmask; /* Default is 0: accept all classes.*/
120			+
121			+void
122			+read_pcimap(void)
123			+{
124			+ struct utsname utsname;
125			+ char filename[MAXPATHLEN];
126			+ FILE *pcimap_file;
127			+ char line[LINELENGTH];
128			+ struct pcimap_entry *entry;
129			+ unsigned int driver_data;
130			+ char *prevmodule = "";
131			+ char module[LINELENGTH];
132			+
133			+ if (uname(&utsname) < 0) {
134			+ perror("uname");
135			+ exit(1);
136			+ }
137			+ sprintf(filename, "%s/%s/%s", MODDIR, utsname.release, PCIMAP);
138			+ if ((pcimap_file = fopen(filename, "r")) == NULL) {
139			+ perror(filename);
140			+ exit(1);
141			+ }
142			+
143			+ while(fgets(line, LINELENGTH, pcimap_file) != NULL) {
144			+ if (line[0] == '#')
145			+ continue;
146			+
147			+ entry = xmalloc(sizeof(struct pcimap_entry));
148			+
149			+ if (sscanf(line, "%s 0x%x 0x%x 0x%x 0x%x 0x%x 0x%x 0x%x",
150			+ module,
151			+ &entry->vendor, &entry->dev,
152			+ &entry->subsys_vendor, &entry->subsys_dev,
153			+ &entry->class, &entry->class_mask,
154			+ &driver_data) != 8) {
155			+ fprintf (stderr,
156			+ "modules.pcimap unparsable line: %s.\n", line);
157			+ free(entry);
158			+ continue;
159			+ }
160			+
161			+ /* Optimize memory allocation a bit, in case someday we
162			+ have Linux systems with ~100,000 modules. It also
163			+ allows us to just compare pointers to avoid trying
164			+ to load a module twice. */
165			+ if (strcmp(module, prevmodule) != 0) {
166			+ prevmodule = xmalloc(strlen(module)+1);
167			+ strcpy(prevmodule, module);
168			+ }
169			+ entry->module = prevmodule;
170			+ entry->next = pcimap_list;
171			+ pcimap_list = entry;
172			+ }
173			+ fclose(pcimap_file);
174			+}
175			+
176			+/* Return a filled in pci_access->dev tree, with the device classes
177			+ stored in dev->aux.
178			+*/
179			+static void
180			+match_pci_modules(void)
181			+{
182			+ struct pci_access *pacc;
183			+ struct pci_dev *dev;
184			+ unsigned int class, subsys_dev, subsys_vendor;
185			+ struct pcimap_entry *map;
186			+ const char *prevmodule = "";
187			+
188			+ pacc = pci_alloc(); /* Get the pci_access structure */
189			+ /* Set all options you want -- here we stick with the defaults */
190			+ pci_init(pacc); /* Initialize the PCI library */
191			+ pci_scan_bus(pacc); /* We want to get the list of devices */
192			+ for(dev=pacc->devices; dev; dev=dev->next) {
193			+ pci_fill_info(dev, PCI_FILL_IDENT \| PCI_FILL_BASES);
194			+ class = (pci_read_word(dev, PCI_CLASS_DEVICE) << 8)
195			+ \| pci_read_byte(dev, PCI_CLASS_PROG);
196			+ subsys_dev = pci_read_word(dev, PCI_SUBSYSTEM_ID);
197			+ subsys_vendor = pci_read_word(dev,PCI_SUBSYSTEM_VENDOR_ID);
198			+ for(map = pcimap_list; map != NULL; map = map->next) {
199			+ if (((map->class ^ class) & map->class_mask) == 0 &&
200			+ ((desired_class ^ class) & desired_classmask)==0 &&
201			+ (map->dev == DEVICE_ANY \|\|
202			+ map->dev == dev->device_id) &&
203			+ (map->vendor == VENDOR_ANY \|\|
204			+ map->vendor == dev->vendor_id) &&
205			+ (map->subsys_dev == DEVICE_ANY \|\|
206			+ map->subsys_dev == subsys_dev) &&
207			+ (map->subsys_vendor == VENDOR_ANY \|\|
208			+ map->subsys_vendor == subsys_vendor) &&
209			+ prevmodule != map->module) {
210			+ printf("%s\n", map->module);
211			+ prevmodule = map->module;
212			+ }
213			+ }
214			+
215			+ }
216			+ pci_cleanup(pacc);
217			+}
218			+
219			+int
220			+main (int argc, char **argv)
221			+{
222			+ int opt_index = 0;
223			+ int opt;
224			+
225			+ while ((opt = getopt_long(argc, argv, OPT_STRING, long_options,
226			+ &opt_index)) != -1) {
227			+ switch(opt) {
228			+ case 'c':
229			+ desired_class = strtol(optarg, NULL, 0);
230			+ break;
231			+ case 'm':
232			+ desired_classmask = strtol(optarg, NULL, 0);
233			+ break;
234			+ case 'h':
235			+ printf ("Usage: pcimodules [--help]\n"
236			+ " Lists kernel modules corresponding to PCI devices currently plugged"
237			+ " into the computer.\n");
238			+ }
239			+ }
240			+
241			+ read_pcimap();
242			+ match_pci_modules();
243			+ return 0;
244			+}
245			--- pciutils-2.2.0/pcimodules.man
246			+++ pciutils-dsd/pcimodules.man
247			@@ -0,0 +1,92 @@
248			+.TH pcimodules 8 "@TODAY@" "@VERSION@" "Linux PCI Utilities"
249			+.IX pcimodules
250			+.SH NAME
251			+pcimodules \- List kernel driver modules available for all currently plugged
252			+in PCI devices
253			+.SH SYNOPSIS
254			+.B pcimodules
255			+.RB [ --class class_id ]
256			+.RB [ --classmask mask ]
257			+.RB [ --help ]
258			+.SH DESCRIPTION
259			+.B pcimodules
260			+lists all driver modules for all currently plugged in PCI devices.
261			+.B pcimodules
262			+should be run at boot time, and whenever a PCI device is "hot plugged"
263			+into the system. This can be done by the following Bourne shell syntax:
264			+.IP
265			+ for module in $(pcimodules) ; do
266			+.IP
267			+ modprobe -s -k "$module"
268			+.IP
269			+ done
270			+.PP
271			+When a PCI device is removed from the system, the Linux kernel will
272			+decrement a usage count on PCI driver module. If this count drops
273			+to zero (i.e., there are no PCI drivers), then the
274			+.B modprobe -r
275			+process that is normally configured to run from cron every few minutes
276			+will eventually remove the unneeded module.
277			+.PP
278			+The --class and --classmask arguments can be used to limit the search
279			+to certain classes of PCI devices. This is useful, for example, to
280			+generate a list of ethernet card drivers to be loaded when the kernel
281			+has indicated that it is trying to resolve an unknown network interface.
282			+.PP
283			+Modules are listed in the order in which the PCI devices are physically
284			+arranged so that the computer owner can arrange things like having scsi
285			+device 0 be on a controller that is not alphabetically the first scsi
286			+controller.
287			+.SH OPTIONS
288			+.TP
289			+.B --class class --classmask mask
290			+.PP
291			+--class and --classmask limit the search to PCI
292			+cards in particular classes. These arguments are always used together.
293			+The arguments to --class and --classmask
294			+can be given as hexadecimal numbers by prefixing a leading "0x".
295			+Note that the classes used by pcimodules are in "Linux" format,
296			+meaning the class value that you see with lspci would be shifted
297			+left eight bits, with the new low eight bits programming interface ID.
298			+An examples of how to use class and classmask is provided below.
299			+.B --help, -h
300			+Print a help message and exit.
301			+.SH EXAMPLES
302			+.TP
303			+pcimodules
304			+lists all modules corresponding to currently plugged in PCI devices.
305			+.TP
306			+pcimodules --class 0x200000 --classmask 0xffff00
307			+lists all modules corresponding to currently plugged in ethernet PCI devices.
308			+.SH FILES
309			+.TP
310			+.B /lib/modules/<kernel-version>/modules.pcimap
311			+This file is automatically generated by
312			+.B depmod,
313			+and used by
314			+.B pcimodules
315			+to determine which modules correspond to which PCI ID's.
316			+.TP
317			+.B /proc/bus/pci
318			+An interface to PCI bus configuration space provided by the post-2.1.82 Linux
319			+kernels. Contains per-bus subdirectories with per-card config space files and a
320			+.I devices
321			+file containing a list of all PCI devices.
322			+
323			+.SH SEE ALSO
324			+.BR lspci (8)
325			+
326			+.SH MAINTAINER
327			+The Linux PCI Utilities are maintained by Martin Mares <mj@suse.cz>.
328			+
329			+.SH AUTHOR
330			+.B pcimodules
331			+was written by Adam J. Richter <adam@yggdrasil.com>, based on public
332			+domain example code by Martin Mares <mj@suse.cz>.
333			+
334			+.SH COPYRIGHT
335			+.B pcimodules
336			+is copyright 2000, Yggdrasil Computing, Incorporated, and may
337			+be copied under the terms and conditions of version 2 of the GNU
338			+General Public License as published by the Free Software Foundation
339			+(Cambrige, Massachusetts, United States of America).