From 3ca6256f87d3a2cc09870a50da5ee07960c9ed45 Mon Sep 17 00:00:00 2001 From: Joachim Wiberg Date: Sat, 7 May 2022 16:28:38 +0200 Subject: [PATCH] doc: update modules-load plugin description, recommend .conf files Signed-off-by: Joachim Wiberg --- doc/plugins.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/doc/plugins.md b/doc/plugins.md index c8e83a0b..641e4240 100644 --- a/doc/plugins.md +++ b/doc/plugins.md @@ -46,11 +46,18 @@ For your convenience a set of *optional* plugins are available: * *rtc.so*: Restore and save system clock from/to RTC on boot/halt. Enabled by default. -* *modules-load.so*: Scans `/etc/modules-load.d/` for modules to load - using `modprobe`. Each file in this directory can contain multiple - lines with the name of the module to load. Any line starting with - the standard UNIX comment character, `#`, is skipped. +* *modules-load.so*: Scans `/etc/modules-load.d/*.conf` for modules to + load using `modprobe`. Each file can contain multiple lines with the + name of the module to load. Any line starting with the standard UNIX + comment character, `#`, is skipped. + Modules are loaded when entering runlevel `[2345]` using the `task` + stanza. Each module gets a unique `name:modprobe.foo`, and + optional`:ID`. The `:ID` is a globally incremented index, which can + be disabled per file (anywhere) using the following config line: + + set noindex + **Note:** unlike the traditional .conf `module` directive, which load any listed module immediately, this plugin creates standard `taks` directives which load the module(s) in the background. As long as