From 11d09ac414bd706ea4a7bf923240655909195da4 Mon Sep 17 00:00:00 2001 From: Emil Velikov Date: Mon, 8 Jul 2024 14:43:19 +0100 Subject: [PATCH] man: modprobe.d: document the config file order handling The modprobe.d configuration order/handling aligns with existing tools such as sysctl.d, even though there is no mention in the manual. Reorder the list in SYNOPSIS and add a bit of verbiage describing things. Section is inspired by sysctl.d(5) and sysctl(8). Signed-off-by: Emil Velikov Signed-off-by: Lucas De Marchi --- man/modprobe.d.5.scd | 33 ++++++++++++++++++++++----------- 1 file changed, 22 insertions(+), 11 deletions(-) diff --git a/man/modprobe.d.5.scd b/man/modprobe.d.5.scd index 2907175..2a6a789 100644 --- a/man/modprobe.d.5.scd +++ b/man/modprobe.d.5.scd @@ -6,25 +6,24 @@ modprobe.d - Configuration directory for modprobe # SYNOPSIS -/lib/modprobe.d/\*.conf - -@DISTCONFDIR@/modprobe.d/\*.conf - -/usr/local/lib/modprobe.d/\*.conf +@SYSCONFDIR@/modprobe.d/\*.conf /run/modprobe.d/\*.conf -/etc/modprobe.d/\*.conf +/usr/local/lib/modprobe.d/\*.conf + +@DISTCONFDIR@/modprobe.d/\*.conf + +/lib/modprobe.d/\*.conf # DESCRIPTION Because the *modprobe* command can add or remove more than one module, due to modules having dependencies, we need a method of specifying what options are to -be used with those modules. All files underneath the /etc/modprobe.d directory -which end with the .conf extension specify those options as required. They can -also be used to create convenient aliases: alternate names for a module, or they -can override the normal *modprobe* behavior altogether for those with special -requirements (such as inserting more than one module). +be used with those modules. One can also use them to create convenient aliases: +alternate names for a module, or they can override the normal *modprobe* +behavior altogether for those with special requirements (such as inserting more +than one module). Note that module and alias names (like other module names) can have - or \_ in them: both are interchangeable throughout all the module commands as underscore @@ -35,6 +34,18 @@ lines and lines starting with '#' ignored (useful for adding comments). A '\\' at the end of a line causes it to continue on the next line, which makes the file a bit neater. +# CONFIGURATION DIRECTORIES AND PRECEDENCE + +Configuration files are read from directories in listed in SYNOPSYS in that +order of precedence. Once a file of a given filename is loaded, any file of the +same name in subsequent directories is ignored. + +All configuration files are sorted in lexicographic order, regardless of the +directory they reside in. Configuration files can either be completely replaced +(by having a new configuration file with the same name in a directory of higher +priority) or partially replaced (by having a configuration file that is ordered +later). + # COMMANDS alias _wildcard_ _modulename_