community.general.kernel_blacklist module – Blacklist kernel modules

Note

This module is part of the community.general collection (version 12.6.1).

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.kernel_blacklist.

Synopsis
Parameters
Attributes
Examples

Synopsis

Add or remove kernel modules from blacklist.

Parameters

Parameter	Comments
blacklist_file string	If specified, use this blacklist file instead of `/etc/modprobe.d/blacklist-ansible.conf`. Default: `"/etc/modprobe.d/blacklist-ansible.conf"`
name string / required	Name of kernel module to black- or whitelist.
state string	Whether the module should be present in the blacklist or absent. Choices: `"absent"` `"present"` ← (default)

Attributes

Attribute	Support	Description
check_mode	Support: full	Can run in `check_mode` and return changed status prediction without modifying target.
diff_mode	Support: full	Returns details on what has changed (or possibly needs changing in `check_mode`), when in diff mode.

Examples

- name: Blacklist the nouveau driver module
  community.general.kernel_blacklist:
    name: nouveau
    state: present

Authors

Matthias Vogelgesang (@matze)

Collection links

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/kernel_blacklist_module.html