community.general.modprobe – Load or unload kernel modules

Note

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

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

Comments

name

string / required

Name of kernel module to manage.

params

string

Modules parameters.

Default: “”

state

string

Whether the module should be present or absent.

Choices:

  • absent

  • present ← (default)

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)