1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
# Kmod Puppet module
[](https://forge.puppetlabs.com/camptocamp/kmod)
[](https://forge.puppetlabs.com/camptocamp/kmod)
[](https://travis-ci.org/camptocamp/puppet-kmod)
[](https://forge.puppetlabs.com/camptocamp/kmod)
[](https://gemnasium.com/camptocamp/puppet-kmod)
[](http://www.camptocamp.com)
## 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
```puppet
kmod::load { 'mymodule': }
```
### kmod::alias
Adds an alias to modprobe.conf, by default `/etc/modprobe.d/<name>.conf` is assumed for a filename.
```puppet
kmod::alias { 'bond0':
modulename => 'bonding',
}
```
Params:
* `modulename`: Name of the module to alias
* `aliasname`: 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
```puppet
kmod::option { 'bond0 mode':
module => 'bond0',
option => 'mode',
value => '1',
}
kmod::option { 'bond0':
option => 'mode',
value => '1',
}
```
Params:
* `option`: Name of the parameter to add
* `value`: Value of the parameter
* `module`: 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`
```puppet
kmod::blacklist { 'foo': }
```
Params:
* `file`: File to write to, defaults to `/etc/modprobe.d/blacklist.conf`
### kmod::install
Manage modprobe install entries
```puppet
kmod::install { 'pcspkr': }
```
If you want to ensure that module can't be loaded at all you can do the following:
```puppet
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](https://github.com/camptocamp/puppet-kmod/issues).
For pull requests, it is very much appreciated to check your Puppet manifest
with [puppet-lint](https://github.com/camptocamp/puppet-kmod/issues) to follow the recommended Puppet style guidelines from the
[Puppet Labs style guide](http://docs.puppetlabs.com/guides/style_guide.html).
|
