Kmod Puppet module
Description
This module provides definitions to manipulate modprobe.conf (5) stanzas:
- kmod::alias
- kmod::install
- kmod::blacklist
It depends on Augeas with the modprobe lens.
Usage
This module has five main defined types:
- kmod::load
- kmod::alias
- kmod::option
- kmod::install
- kmod::blacklist
kmod::load
Loads a module using modprobe and manages persistent modules in /etc/sysconfig/modules
kmod::load { 'mymodule': }
kmod::alias
Adds an alias to modprobe.conf, by default /etc/modprobe.d/<name>.conf
is assumed for a filename.
kmod::alias { 'bond0':
modulename => '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)
kmod::option
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
)
kmod::blacklist
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
kmod::install
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
Contributing
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.