This module provides definitions to manipulate modprobe.conf (5) stanzas:
- kmod::alias
- kmod::install
- kmod::blacklist
It depends on Augeas with the modprobe lens.
This module has five main defined types:
- kmod::load
- kmod::alias
- kmod::option
- kmod::install
- kmod::blacklist
Loads a module using modprobe and manages persistent modules in /etc/sysconfig/modules
kmod::load { 'mymodule': }
Adds an alias to modprobe.conf, by default /etc/modprobe.d/<name>.conf
is assumed for a filename.
kmod::alias { 'bond0':
aliasname => 'bonding',
}
Params:
modulename
: Name of the module to aliasaliasname
: Name of the alias (defaults to the resource title)file
: File to write to (see above default)
Adds an option to modprobe.conf
kmod::option { 'bond0 mode':
module => 'bond0',
option => 'mode',
value => '1',
}
kmod::option { 'bond0':
option => 'mode',
value => '1',
}
Params:
option
: Name of the parameter to addvalue
: Value of the parametermodule
: Name of the module (if ommited, the resource title is used)file
: File to write to (defaults to/etc/modprobe.d/<module name>.conf
)
Manages modprobe blacklist entries. Blacklist entries prevents module aliases from being used,
but would not prevent the module from being loaded.
To prevent a module from being loaded use kmod::install
kmod::blacklist { 'foo': }
Params:
file
: File to write to, defaults to/etc/modprobe.d/blacklist.conf
Manage modprobe install entries
kmod::install { 'pcspkr': }
If you want to ensure that module can't be loaded at all you can do the following:
kmod::install { 'dccp': command => '/bin/false' }
Params:
file
: File to write to (defaults to/etc/modprobe.d/<module name>.conf
)command
: (optional) command associated with the install, defaults to/bin/true
The module makes available lists for every defined type that will create those defined types if defined as class parameters. The parameters are:
- kmod::list_of_blacklists:
- kmod::list_of_aliases:
- kmod::list_of_installs:
- kmod::list_of_loads:
- kmod::list_of_options:
Example usage:
---
kmod::list_of_blacklists:
'foo01': {}
'foo02': {}
'foo03': {}
kmod::list_of_aliases:
'foo01':
source: 'squashfs'
aliasname: 'squash01'
'foo02':
source: 'squashfs'
aliasname: 'squash02'
kmod::list_of_installs:
'dccp':
command: '/bin/false'
'blah':
command: '/bin/true'
kmod::list_of_loads:
'cramfs': {}
'vfat': {}
kmod::list_of_options:
'bond0 mode':
module: 'bond0'
option: 'mode'
value: '1'
'bond0':
option: 'mode'
value: '1'
Please report bugs and feature request using GitHub issue tracker.
For pull requests, it is very much appreciated to check your Puppet manifest with puppet-lint to follow the recommended Puppet style guidelines from the Puppet Labs style guide.