community.general.modprobe – Load or unload kernel modules

Note

This plugin is part of the community.general collection (version 4.2.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.modprobe.

Synopsis

  • Load or unload kernel modules.

Parameters

Parameter Choices/Defaults Comments
name
string / required
Name of kernel module to manage.
params
string
Default:
""
Modules parameters.
state
string
    Choices:
  • absent
  • present ←
Whether the module should be present or absent.

Examples

- name: Add the 802.1q module
  community.general.modprobe:
    name: 8021q
    state: present

- name: Add the dummy module
  community.general.modprobe:
    name: dummy
    state: present
    params: 'numdummies=2'

Authors

  • David Stygstra (@stygstra)

  • Julien Dauphant (@jdauphant)

  • Matt Jeffery (@mattjeffery)