Commit 0317c537 authored by Stephen Kitt's avatar Stephen Kitt Committed by Jonathan Corbet
Browse files

docs: merge debugging-modules.txt into sysctl/kernel.rst 



This fits nicely in sysctl/kernel.rst, merge it (and rephrase it)
instead of linking to it.

Signed-off-by: default avatarStephen Kitt <steve@sk2.org>
Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent a3cb66a5

Documentation/admin-guide/sysctl/kernel.rst

+13 −1
Original line number Diff line number Diff line
@@ -387,7 +387,19 @@ This flag controls the L2 cache of G3 processor boards. If 
modprobe

========



See Documentation/debugging-modules.txt.

This gives the full path of the modprobe command which the kernel will

use to load modules. This can be used to debug module loading

requests::



    echo '#! /bin/sh' > /tmp/modprobe

    echo 'echo "$@" >> /tmp/modprobe.log' >> /tmp/modprobe

    echo 'exec /sbin/modprobe "$@"' >> /tmp/modprobe

    chmod a+x /tmp/modprobe

    echo /tmp/modprobe > /proc/sys/kernel/modprobe



This only applies when the *kernel* is requesting that the module be

loaded; it won't have any effect if the module is being loaded

explicitly using ``modprobe`` from userspace.





modules_disabled

Documentation/debugging-modules.txt

deleted100644 → 0
+0 −22
Original line number Diff line number Diff line 
Debugging Modules after 2.6.3

-----------------------------



In almost all distributions, the kernel asks for modules which don't

exist, such as "net-pf-10" or whatever.  Changing "modprobe -q" to

"succeed" in this case is hacky and breaks some setups, and also we

want to know if it failed for the fallback code for old aliases in

fs/char_dev.c, for example.



In the past a debugging message which would fill people's logs was

emitted.  This debugging message has been removed.  The correct way

of debugging module problems is something like this:



echo '#! /bin/sh' > /tmp/modprobe

echo 'echo "$@" >> /tmp/modprobe.log' >> /tmp/modprobe

echo 'exec /sbin/modprobe "$@"' >> /tmp/modprobe

chmod a+x /tmp/modprobe

echo /tmp/modprobe > /proc/sys/kernel/modprobe



Note that the above applies only when the *kernel* is requesting

that the module be loaded -- it won't have any effect if that module

is being loaded explicitly using "modprobe" from userspace.