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
Loading
Loading
Loading
Loading
+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
+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.