1MODULES-LOAD.D(5)               modules-load.d               MODULES-LOAD.D(5)
2
3
4

NAME

6       modules-load.d - Configure kernel modules to load at boot
7

SYNOPSIS

9       /etc/modules-load.d/*.conf
10
11       /run/modules-load.d/*.conf
12
13       /usr/lib/modules-load.d/*.conf
14

DESCRIPTION

16       systemd-modules-load.service(8) reads files from the above directories
17       which contain kernel modules to load during boot in a static list. Each
18       configuration file is named in the style of
19       /etc/modules-load.d/program.conf. Note that it is usually a better idea
20       to rely on the automatic module loading by PCI IDs, USB IDs, DMI IDs or
21       similar triggers encoded in the kernel modules themselves instead of
22       static configuration like this. In fact, most modern kernel modules are
23       prepared for automatic loading already.
24

CONFIGURATION FORMAT

26       The configuration files should simply contain a list of kernel module
27       names to load, separated by newlines. Empty lines and lines whose first
28       non-whitespace character is # or ; are ignored.
29

CONFIGURATION DIRECTORIES AND PRECEDENCE

31       Configuration files are read from directories in /etc/, /run/, and
32       /usr/lib/, in order of precedence. Each configuration file in these
33       configuration directories shall be named in the style of filename.conf.
34       Files in /etc/ override files with the same name in /run/ and
35       /usr/lib/. Files in /run/ override files with the same name in
36       /usr/lib/.
37
38       Packages should install their configuration files in /usr/lib/. Files
39       in /etc/ are reserved for the local administrator, who may use this
40       logic to override the configuration files installed by vendor packages.
41       All configuration files are sorted by their filename in lexicographic
42       order, regardless of which of the directories they reside in. If
43       multiple files specify the same option, the entry in the file with the
44       lexicographically latest name will take precedence. It is recommended
45       to prefix all filenames with a two-digit number and a dash, to simplify
46       the ordering of the files.
47
48       If the administrator wants to disable a configuration file supplied by
49       the vendor, the recommended way is to place a symlink to /dev/null in
50       the configuration directory in /etc/, with the same filename as the
51       vendor configuration file. If the vendor configuration file is included
52       in the initrd image, the image has to be regenerated.
53

EXAMPLE

55       Example 1. /etc/modules-load.d/virtio-net.conf example:
56
57           # Load virtio-net.ko at boot
58           virtio-net
59

SEE ALSO

61       systemd(1), systemd-modules-load.service(8), systemd-delta(1),
62       modprobe(8)
63
64
65
66systemd 239                                                  MODULES-LOAD.D(5)
Impressum