man: add MODULE_ALTERNATIVE_DIRECTORY documentation

Esplicitly define MODULE_ALTERNATIVE_DIRECTORY in the docs
as fallback directory if MODULE_DIRECTORY is missing or
the module is not present there.

Signed-off-by: Emanuele Giuseppe Esposito <[email protected]>

Author: esposem

man/insmod.8.scd

@@ -18,6 +18,12 @@ Only the most general of error messages are reported: as the work of trying to
 link the module is now done inside the kernel, the *dmesg*(1) usually gives more
 information about errors.
 
+*insmod* will look by default at modules stored in @MODULE_DIRECTORY@, but if
+the folder is missing or the module is not found, it will automatically look at
+the fallback directory @MODULE_ALTERNATIVE_DIRECTORY@.
+This program will fail only if the provided module is not found in both
+directories.
+
 # OPTIONS
 
 *-f*, *--force*

man/lsmod.8.scd

@@ -13,6 +13,9 @@ lsmod - Show the status of modules in the Linux Kernel
 *lsmod* is a trivial program which nicely formats the contents of the
 _/proc/modules_, showing what kernel modules are currently loaded.
 
+*lsmod* will look by default at modules stored in @MODULE_DIRECTORY@, but if
+the folder is missing , it will automatically look at the fallback directory @MODULE_ALTERNATIVE_DIRECTORY@.
+
 # OPTIONS
 
 *-s*, *--syslog*

man/modinfo.8.scd

@@ -15,9 +15,18 @@ modinfo - Show information about a Linux Kernel module
 # DESCRIPTION
 
 *modinfo* extracts information from the Linux Kernel modules given on the
-command line. If the module name is not a filename, then the @MODULE_DIRECTORY@/
-_version_ directory is searched, as is also done by *modprobe*(8) when loading
-kernel modules.
+command line.
+
+*modinfo* will search by default for modules stored in @MODULE_DIRECTORY@, but
+if the folder is missing or the module is not found, it will automatically look
+at the fallback directory @MODULE_ALTERNATIVE_DIRECTORY@.
+This program will fail only if the provided module is not found in both
+directories.
+
+If the module name is not a filename, then the @MODULE_DIRECTORY@/
+_version_ directory is searched first, and then
+@MODULE_ALTERNATIVE_DIRECTORY@/_version_, as is also done by *modprobe*(8) when
+loading kernel modules.
 
 *modinfo* by default lists each attribute of the module in form _fieldname_ :
 _value_, for easy reading. The filename is listed the same way (although it's

man/modprobe.8.scd

@@ -44,6 +44,12 @@ is relative, it must explicitly start with "./". Note that this may fail when
 using a path to a module with dependencies not matching the installed *depmod*
 database.
 
+*modprobe* will search by default for modules stored in @MODULE_DIRECTORY@, but
+if the folder is missing or the module is not found, it will automatically look
+at the fallback directory @MODULE_ALTERNATIVE_DIRECTORY@.
+This program will fail only if the provided module is not found in both
+directories.
+
 # OPTIONS
 
 *-a*, *--all*

man/rmmod.8.scd

@@ -15,6 +15,12 @@ kernel (when module unloading support is provided). Most users will want to use
 *modprobe*(8) with the *-r* option instead since it removes unused dependent
 modules as well.
 
+*rmmod* will look by default at modules stored in @MODULE_DIRECTORY@, but if
+the folder is missing or the module is not found, it will automatically look at
+the fallback directory @MODULE_ALTERNATIVE_DIRECTORY@.
+This program will fail only if the provided module is not found in both
+directories.
+
 When a list of modules is provided, the program will process them one at a time.
 If a module is not found, *rmmod* will immediately exit with an error code.
 Should the module removal fail, the program will log an error AND continue with