Documentation: replace install commands with softdeps

Install commands should not be used to specify soft dependencies among modules. When loading modules it's much better to have a softdep that modprobe knows what's being done than having to fork/exec another instance of modprobe to load the other module. By using a softdep user has also an option to remove the dependencies when removing the module (and if its refcount dropped to 0) Signed-off-by: Lucas De Marchi <lucas.demarchi@profusion.mobi> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

Documentation: replace install commands with softdeps
Install commands should not be used to specify soft dependencies among modules. When loading modules it's much better to have a softdep that modprobe knows what's being done than having to fork/exec another instance of modprobe to load the other module. By using a softdep user has also an option to remove the dependencies when removing the module (and if its refcount dropped to 0) Signed-off-by: Lucas De Marchi <lucas.demarchi@profusion.mobi> Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Lucas De Marchi · Linus Torvalds
1 parent 970e248649
Showing 3 changed files with 4 additions and 5 deletions Side-by-side Diff
Documentation/networking/bonding.txt
Documentation/sound/oss/AudioExcelDSP16
Documentation/sound/oss/README.modules
@@ -1822,8 +1822,7 @@
 In this case, the following can be added to config files in
 /etc/modprobe.d/ as:
  
-install bonding /sbin/modprobe tg3; /sbin/modprobe e1000;
-	/sbin/modprobe --ignore-install bonding
+softdep bonding pre: tg3 e1000
  
 	This will load tg3 and e1000 modules before loading the bonding one.
 Full documentation on this can be found in the modprobe.d and modprobe
@@ -54,8 +54,8 @@
 the sound card. Installation dependencies must be written in configuration
 files under /etc/modprobe.d/ directory:
  
-install ad1848 /sbin/modprobe aedsp16 && /sbin/modprobe -i ad1848
-install opl3 /sbin/modprobe aedsp16 && /sbin/modprobe -i opl3
+softdep ad1848 pre: aedsp16
+softdep opl3 pre: aedsp16
  
 Then you must load the sound modules stack in this order:
 sound -> aedsp16 -> [ ad1848, opl3 ]
@@ -36,7 +36,7 @@
  Alternatively, if you have compiled in kernel level ISAPnP support:
  
 alias char-major-14 sb
-post-install sb /sbin/modprobe "-k" "adlib_card"
+softdep sb post: adlib_card
 options adlib_card io=0x388
  
   The effect of this is that the sound driver and all necessary bits and
...	...	@@ -1822,8 +1822,7 @@
1822	1822	In this case, the following can be added to config files in
1823	1823	/etc/modprobe.d/ as:
1824	1824
1825		-install bonding /sbin/modprobe tg3; /sbin/modprobe e1000;
1826		- /sbin/modprobe --ignore-install bonding
	1825	+softdep bonding pre: tg3 e1000
1827	1826
1828	1827	This will load tg3 and e1000 modules before loading the bonding one.
1829	1828	Full documentation on this can be found in the modprobe.d and modprobe
...	...	@@ -54,8 +54,8 @@
54	54	the sound card. Installation dependencies must be written in configuration
55	55	files under /etc/modprobe.d/ directory:
56	56
57		-install ad1848 /sbin/modprobe aedsp16 && /sbin/modprobe -i ad1848
58		-install opl3 /sbin/modprobe aedsp16 && /sbin/modprobe -i opl3
	57	+softdep ad1848 pre: aedsp16
	58	+softdep opl3 pre: aedsp16
59	59
60	60	Then you must load the sound modules stack in this order:
61	61	sound -> aedsp16 -> [ ad1848, opl3 ]
...	...	@@ -36,7 +36,7 @@
36	36	Alternatively, if you have compiled in kernel level ISAPnP support:
37	37
38	38	alias char-major-14 sb
39		-post-install sb /sbin/modprobe "-k" "adlib_card"
	39	+softdep sb post: adlib_card
40	40	options adlib_card io=0x388
41	41
42	42	The effect of this is that the sound driver and all necessary bits and