Skip to content

Commit 970e248

Browse files
Lucas De Marchitorvalds
Lucas De Marchi
authored andcommitted
Documentation: remove references to /etc/modprobe.conf
Usage of /etc/modprobe.conf file was deprecated by module-init-tools and is no longer parsed by new kmod tool. References to this file are replaced in Documentation, comments and Kconfig according to the context. There are also some references to the old /etc/modules.conf from 2.4 kernels that are being removed. Signed-off-by: Lucas De Marchi <lucas.demarchi@profusion.mobi> Acked-by: Takashi Iwai <tiwai@suse.de> Acked-by: Mauro Carvalho Chehab <mchehab@redhat.com> Signed-off-by: Randy Dunlap <rdunlap@xenotime.net> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
1 parent 0960152 commit 970e248

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

50 files changed

+138
-160
lines changed

Documentation/aoe/aoe.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ CREATING DEVICE NODES
3535
sh Documentation/aoe/mkshelf.sh /dev/etherd 0
3636

3737
There is also an autoload script that shows how to edit
38-
/etc/modprobe.conf to ensure that the aoe module is loaded when
38+
/etc/modprobe.d/aoe.conf to ensure that the aoe module is loaded when
3939
necessary.
4040

4141
USING DEVICE NODES

Documentation/aoe/autoload.sh

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
#!/bin/sh
22
# set aoe to autoload by installing the
3-
# aliases in /etc/modprobe.conf
3+
# aliases in /etc/modprobe.d/
44

5-
f=/etc/modprobe.conf
5+
f=/etc/modprobe.d/aoe.conf
66

77
if test ! -r $f || test ! -w $f; then
88
echo "cannot configure $f for module autoloading" 1>&2

Documentation/blockdev/floppy.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ you can put:
4949

5050
options floppy omnibook messages
5151

52-
in /etc/modprobe.conf.
52+
in a configuration file in /etc/modprobe.d/.
5353

5454

5555
The floppy driver related options are:

Documentation/fb/intel810.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -211,7 +211,7 @@ Using the same setup as described above, load the module like this:
211211
modprobe i810fb vram=2 xres=1024 bpp=8 hsync1=30 hsync2=55 vsync1=50 \
212212
vsync2=85 accel=1 mtrr=1
213213

214-
Or just add the following to /etc/modprobe.conf
214+
Or just add the following to a configuration file in /etc/modprobe.d/
215215

216216
options i810fb vram=2 xres=1024 bpp=16 hsync1=30 hsync2=55 vsync1=50 \
217217
vsync2=85 accel=1 mtrr=1

Documentation/fb/intelfb.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,7 @@ Using the same setup as described above, load the module like this:
120120

121121
modprobe intelfb mode=800x600-32@75 vram=8 accel=1 hwcursor=1
122122

123-
Or just add the following to /etc/modprobe.conf
123+
Or just add the following to a configuration file in /etc/modprobe.d/
124124

125125
options intelfb mode=800x600-32@75 vram=8 accel=1 hwcursor=1
126126

Documentation/i2c/busses/scx200_acb

+1-1
Original file line numberDiff line numberDiff line change
@@ -28,5 +28,5 @@ If the scx200_acb driver is built into the kernel, add the following
2828
parameter to your boot command line:
2929
scx200_acb.base=0x810,0x820
3030
If the scx200_acb driver is built as a module, add the following line to
31-
the file /etc/modprobe.conf instead:
31+
a configuration file in /etc/modprobe.d/ instead:
3232
options scx200_acb base=0x810,0x820

Documentation/ide/ide.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -169,7 +169,7 @@ When using ide.c as a module in combination with kmod, add:
169169

170170
alias block-major-3 ide-probe
171171

172-
to /etc/modprobe.conf.
172+
to a configuration file in /etc/modprobe.d/.
173173

174174
When ide.c is used as a module, you can pass command line parameters to the
175175
driver using the "options=" keyword to insmod, while replacing any ',' with

Documentation/isdn/README.gigaset

+7-9
Original file line numberDiff line numberDiff line change
@@ -97,8 +97,7 @@ GigaSet 307x Device Driver
9797
2.5.): 1=on (default), 0=off
9898

9999
Depending on your distribution you may want to create a separate module
100-
configuration file /etc/modprobe.d/gigaset for these, or add them to a
101-
custom file like /etc/modprobe.conf.local.
100+
configuration file like /etc/modprobe.d/gigaset.conf for these.
102101

103102
2.2. Device nodes for user space programs
104103
------------------------------------
@@ -212,8 +211,8 @@ GigaSet 307x Device Driver
212211

213212
options ppp_async flag_time=0
214213

215-
to an appropriate module configuration file, like /etc/modprobe.d/gigaset
216-
or /etc/modprobe.conf.local.
214+
to an appropriate module configuration file, like
215+
/etc/modprobe.d/gigaset.conf.
217216

218217
Unimodem mode is needed for making some devices [e.g. SX100] work which
219218
do not support the regular Gigaset command set. If debug output (see
@@ -237,8 +236,8 @@ GigaSet 307x Device Driver
237236
modprobe usb_gigaset startmode=0
238237
or by adding a line like
239238
options usb_gigaset startmode=0
240-
to an appropriate module configuration file, like /etc/modprobe.d/gigaset
241-
or /etc/modprobe.conf.local.
239+
to an appropriate module configuration file, like
240+
/etc/modprobe.d/gigaset.conf
242241

243242
2.6. Call-ID (CID) mode
244243
------------------
@@ -310,7 +309,7 @@ GigaSet 307x Device Driver
310309

311310
options isdn dialtimeout=15
312311

313-
to /etc/modprobe.d/gigaset, /etc/modprobe.conf.local or a similar file.
312+
to /etc/modprobe.d/gigaset.conf or a similar file.
314313

315314
Problem:
316315
The isdnlog program emits error messages or just doesn't work.
@@ -350,8 +349,7 @@ GigaSet 307x Device Driver
350349
The initial value can be set using the debug parameter when loading the
351350
module "gigaset", e.g. by adding a line
352351
options gigaset debug=0
353-
to your module configuration file, eg. /etc/modprobe.d/gigaset or
354-
/etc/modprobe.conf.local.
352+
to your module configuration file, eg. /etc/modprobe.d/gigaset.conf
355353

356354
Generated debugging information can be found
357355
- as output of the command

Documentation/laptops/sonypi.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ Module use:
110110
-----------
111111

112112
In order to automatically load the sonypi module on use, you can put those
113-
lines in your /etc/modprobe.conf file:
113+
lines a configuration file in /etc/modprobe.d/:
114114

115115
alias char-major-10-250 sonypi
116116
options sonypi minor=250

Documentation/mono.txt

+4-4
Original file line numberDiff line numberDiff line change
@@ -38,11 +38,11 @@ if [ ! -e /proc/sys/fs/binfmt_misc/register ]; then
3838
/sbin/modprobe binfmt_misc
3939
# Some distributions, like Fedora Core, perform
4040
# the following command automatically when the
41-
# binfmt_misc module is loaded into the kernel.
41+
# binfmt_misc module is loaded into the kernel
42+
# or during normal boot up (systemd-based systems).
4243
# Thus, it is possible that the following line
43-
# is not needed at all. Look at /etc/modprobe.conf
44-
# to check whether this is applicable or not.
45-
mount -t binfmt_misc none /proc/sys/fs/binfmt_misc
44+
# is not needed at all.
45+
mount -t binfmt_misc none /proc/sys/fs/binfmt_misc
4646
fi
4747

4848
# Register support for .NET CLR binaries

Documentation/networking/baycom.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ Every time a driver is inserted into the kernel, it has to know which
9393
modems it should access at which ports. This can be done with the setbaycom
9494
utility. If you are only using one modem, you can also configure the
9595
driver from the insmod command line (or by means of an option line in
96-
/etc/modprobe.conf).
96+
/etc/modprobe.d/*.conf).
9797

9898
Examples:
9999
modprobe baycom_ser_fdx mode="ser12*" iobase=0x3f8 irq=4

Documentation/networking/bonding.txt

+18-25
Original file line numberDiff line numberDiff line change
@@ -173,9 +173,8 @@ bonding module at load time, or are specified via sysfs.
173173

174174
Module options may be given as command line arguments to the
175175
insmod or modprobe command, but are usually specified in either the
176-
/etc/modules.conf or /etc/modprobe.conf configuration file, or in a
177-
distro-specific configuration file (some of which are detailed in the next
178-
section).
176+
/etc/modrobe.d/*.conf configuration files, or in a distro-specific
177+
configuration file (some of which are detailed in the next section).
179178

180179
Details on bonding support for sysfs is provided in the
181180
"Configuring Bonding Manually via Sysfs" section, below.
@@ -1021,7 +1020,7 @@ ifcfg-bondX files.
10211020

10221021
Because the sysconfig scripts supply the bonding module
10231022
options in the ifcfg-bondX file, it is not necessary to add them to
1024-
the system /etc/modules.conf or /etc/modprobe.conf configuration file.
1023+
the system /etc/modules.d/*.conf configuration files.
10251024

10261025
3.2 Configuration with Initscripts Support
10271026
------------------------------------------
@@ -1098,15 +1097,13 @@ queried targets, e.g.,
10981097
arp_ip_target=+192.168.1.1 arp_ip_target=+192.168.1.2
10991098

11001099
is the proper syntax to specify multiple targets. When specifying
1101-
options via BONDING_OPTS, it is not necessary to edit /etc/modules.conf or
1102-
/etc/modprobe.conf.
1100+
options via BONDING_OPTS, it is not necessary to edit /etc/modprobe.d/*.conf.
11031101

11041102
For even older versions of initscripts that do not support
1105-
BONDING_OPTS, it is necessary to edit /etc/modules.conf (or
1106-
/etc/modprobe.conf, depending upon your distro) to load the bonding module
1107-
with your desired options when the bond0 interface is brought up. The
1108-
following lines in /etc/modules.conf (or modprobe.conf) will load the
1109-
bonding module, and select its options:
1103+
BONDING_OPTS, it is necessary to edit /etc/modprobe.d/*.conf, depending upon
1104+
your distro) to load the bonding module with your desired options when the
1105+
bond0 interface is brought up. The following lines in /etc/modprobe.d/*.conf
1106+
will load the bonding module, and select its options:
11101107

11111108
alias bond0 bonding
11121109
options bond0 mode=balance-alb miimon=100
@@ -1152,7 +1149,7 @@ knowledge of bonding. One such distro is SuSE Linux Enterprise Server
11521149
version 8.
11531150

11541151
The general method for these systems is to place the bonding
1155-
module parameters into /etc/modules.conf or /etc/modprobe.conf (as
1152+
module parameters into a config file in /etc/modprobe.d/ (as
11561153
appropriate for the installed distro), then add modprobe and/or
11571154
ifenslave commands to the system's global init script. The name of
11581155
the global init script differs; for sysconfig, it is
@@ -1228,7 +1225,7 @@ network initialization scripts.
12281225
specify a different name for each instance (the module loading system
12291226
requires that every loaded module, even multiple instances of the same
12301227
module, have a unique name). This is accomplished by supplying multiple
1231-
sets of bonding options in /etc/modprobe.conf, for example:
1228+
sets of bonding options in /etc/modprobe.d/*.conf, for example:
12321229

12331230
alias bond0 bonding
12341231
options bond0 -o bond0 mode=balance-rr miimon=100
@@ -1793,8 +1790,8 @@ route additions may cause trouble.
17931790
On systems with network configuration scripts that do not
17941791
associate physical devices directly with network interface names (so
17951792
that the same physical device always has the same "ethX" name), it may
1796-
be necessary to add some special logic to either /etc/modules.conf or
1797-
/etc/modprobe.conf (depending upon which is installed on the system).
1793+
be necessary to add some special logic to config files in
1794+
/etc/modprobe.d/.
17981795

17991796
For example, given a modules.conf containing the following:
18001797

@@ -1821,20 +1818,16 @@ add above bonding e1000 tg3
18211818
bonding is loaded. This command is fully documented in the
18221819
modules.conf manual page.
18231820

1824-
On systems utilizing modprobe.conf (or modprobe.conf.local),
1825-
an equivalent problem can occur. In this case, the following can be
1826-
added to modprobe.conf (or modprobe.conf.local, as appropriate), as
1827-
follows (all on one line; it has been split here for clarity):
1821+
On systems utilizing modprobe an equivalent problem can occur.
1822+
In this case, the following can be added to config files in
1823+
/etc/modprobe.d/ as:
18281824

18291825
install bonding /sbin/modprobe tg3; /sbin/modprobe e1000;
18301826
/sbin/modprobe --ignore-install bonding
18311827

1832-
This will, when loading the bonding module, rather than
1833-
performing the normal action, instead execute the provided command.
1834-
This command loads the device drivers in the order needed, then calls
1835-
modprobe with --ignore-install to cause the normal action to then take
1836-
place. Full documentation on this can be found in the modprobe.conf
1837-
and modprobe manual pages.
1828+
This will load tg3 and e1000 modules before loading the bonding one.
1829+
Full documentation on this can be found in the modprobe.d and modprobe
1830+
manual pages.
18381831

18391832
8.3. Painfully Slow Or No Failed Link Detection By Miimon
18401833
---------------------------------------------------------

Documentation/networking/dl2k.txt

+6-5
Original file line numberDiff line numberDiff line change
@@ -45,12 +45,13 @@ Now eth0 should active, you can test it by "ping" or get more information by
4545
"ifconfig". If tested ok, continue the next step.
4646

4747
4. cp dl2k.ko /lib/modules/`uname -r`/kernel/drivers/net
48-
5. Add the following line to /etc/modprobe.conf:
48+
5. Add the following line to /etc/modprobe.d/dl2k.conf:
4949
alias eth0 dl2k
50-
6. Run "netconfig" or "netconf" to create configuration script ifcfg-eth0
50+
6. Run depmod to updated module indexes.
51+
7. Run "netconfig" or "netconf" to create configuration script ifcfg-eth0
5152
located at /etc/sysconfig/network-scripts or create it manually.
5253
[see - Configuration Script Sample]
53-
7. Driver will automatically load and configure at next boot time.
54+
8. Driver will automatically load and configure at next boot time.
5455

5556
Compiling the Driver
5657
====================
@@ -154,8 +155,8 @@ Installing the Driver
154155
-----------------
155156
1. Copy dl2k.o to the network modules directory, typically
156157
/lib/modules/2.x.x-xx/net or /lib/modules/2.x.x/kernel/drivers/net.
157-
2. Locate the boot module configuration file, most commonly modprobe.conf
158-
or modules.conf (for 2.4) in the /etc directory. Add the following lines:
158+
2. Locate the boot module configuration file, most commonly in the
159+
/etc/modprobe.d/ directory. Add the following lines:
159160

160161
alias ethx dl2k
161162
options dl2k <optional parameters>

Documentation/networking/e100.txt

+3-3
Original file line numberDiff line numberDiff line change
@@ -94,16 +94,16 @@ Additional Configurations
9494

9595
Configuring a network driver to load properly when the system is started is
9696
distribution dependent. Typically, the configuration process involves adding
97-
an alias line to /etc/modules.conf or /etc/modprobe.conf as well as editing
98-
other system startup scripts and/or configuration files. Many popular Linux
97+
an alias line to /etc/modprobe.d/*.conf as well as editing other system
98+
startup scripts and/or configuration files. Many popular Linux
9999
distributions ship with tools to make these changes for you. To learn the
100100
proper way to configure a network device for your system, refer to your
101101
distribution documentation. If during this process you are asked for the
102102
driver or module name, the name for the Linux Base Driver for the Intel
103103
PRO/100 Family of Adapters is e100.
104104

105105
As an example, if you install the e100 driver for two PRO/100 adapters
106-
(eth0 and eth1), add the following to modules.conf or modprobe.conf:
106+
(eth0 and eth1), add the following to a configuraton file in /etc/modprobe.d/
107107

108108
alias eth0 e100
109109
alias eth1 e100

Documentation/networking/ipv6.txt

+3-3
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
Options for the ipv6 module are supplied as parameters at load time.
33

44
Module options may be given as command line arguments to the insmod
5-
or modprobe command, but are usually specified in either the
6-
/etc/modules.conf or /etc/modprobe.conf configuration file, or in a
7-
distro-specific configuration file.
5+
or modprobe command, but are usually specified in either
6+
/etc/modules.d/*.conf configuration files, or in a distro-specific
7+
configuration file.
88

99
The available ipv6 module parameters are listed below. If a parameter
1010
is not specified the default value is used.

Documentation/networking/ixgb.txt

+3-3
Original file line numberDiff line numberDiff line change
@@ -274,9 +274,9 @@ Additional Configurations
274274
-------------------------------------------------
275275
Configuring a network driver to load properly when the system is started is
276276
distribution dependent. Typically, the configuration process involves adding
277-
an alias line to /etc/modprobe.conf as well as editing other system startup
278-
scripts and/or configuration files. Many popular Linux distributions ship
279-
with tools to make these changes for you. To learn the proper way to
277+
an alias line to files in /etc/modprobe.d/ as well as editing other system
278+
startup scripts and/or configuration files. Many popular Linux distributions
279+
ship with tools to make these changes for you. To learn the proper way to
280280
configure a network device for your system, refer to your distribution
281281
documentation. If during this process you are asked for the driver or module
282282
name, the name for the Linux Base Driver for the Intel 10GbE Family of

Documentation/networking/ltpc.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ the driver will try to determine them itself.
2525

2626
If you load the driver as a module, you can pass the parameters "io=",
2727
"irq=", and "dma=" on the command line with insmod or modprobe, or add
28-
them as options in /etc/modprobe.conf:
28+
them as options in a configuration file in /etc/modprobe.d/ directory:
2929

3030
alias lt0 ltpc # autoload the module when the interface is configured
3131
options ltpc io=0x240 irq=9 dma=1

Documentation/networking/vortex.txt

+3-3
Original file line numberDiff line numberDiff line change
@@ -67,8 +67,8 @@ Module parameters
6767
=================
6868

6969
There are several parameters which may be provided to the driver when
70-
its module is loaded. These are usually placed in /etc/modprobe.conf
71-
(/etc/modules.conf in 2.4). Example:
70+
its module is loaded. These are usually placed in /etc/modprobe.d/*.conf
71+
configuretion files. Example:
7272

7373
options 3c59x debug=3 rx_copybreak=300
7474

@@ -425,7 +425,7 @@ steps you should take:
425425
1) Increase the debug level. Usually this is done via:
426426

427427
a) modprobe driver debug=7
428-
b) In /etc/modprobe.conf (or /etc/modules.conf for 2.4):
428+
b) In /etc/modprobe.d/driver.conf:
429429
options driver debug=7
430430

431431
2) Recreate the problem with the higher debug level,

Documentation/parport.txt

+6-7
Original file line numberDiff line numberDiff line change
@@ -36,18 +36,17 @@ addresses should not be specified for supported PCI cards since they
3636
are automatically detected.
3737

3838

39-
KMod
40-
----
39+
modprobe
40+
--------
4141

42-
If you use kmod, you will find it useful to edit /etc/modprobe.conf.
43-
Here is an example of the lines that need to be added:
42+
If you use modprobe , you will find it useful to add lines as below to a
43+
configuration file in /etc/modprobe.d/ directory:.
4444

4545
alias parport_lowlevel parport_pc
4646
options parport_pc io=0x378,0x278 irq=7,auto
4747

48-
KMod will then automatically load parport_pc (with the options
49-
"io=0x378,0x278 irq=7,auto") whenever a parallel port device driver
50-
(such as lp) is loaded.
48+
modprobe will load parport_pc (with the options "io=0x378,0x278 irq=7,auto")
49+
whenever a parallel port device driver (such as lp) is loaded.
5150

5251
Note that these are example lines only! You shouldn't in general need
5352
to specify any options to parport_pc in order to be able to use a

0 commit comments

Comments
 (0)