sysctl - Manage entries in sysctl.conf.

Author:David “DaviXX” CHANIAL <david.chanial@gmail.com>

Synopsis

New in version 1.0.

This module manipulates sysctl entries and optionally performs a /sbin/sysctl -p after changing them.

Options

parameter	required	default	choices	comments
ignoreerrors	no		yes no	Use this option to ignore errors about unknown keys.
name	yes			The dot-separated path (aka key) specifying the sysctl variable.
reload	no	yes	yes no	If yes, performs a /sbin/sysctl -p if the sysctl_file is updated. If no, does not reload sysctl even if the sysctl_file is updated.
state	no	present	present absent	Whether the entry should be present or absent in the sysctl file.
sysctl_file	no	/etc/sysctl.conf		Specifies the absolute path to sysctl.conf, if not /etc/sysctl.conf.
sysctl_set	no		yes no	Verify token value with the sysctl command and set with -w if necessary (added in Ansible 1.5)
value	no			Desired value of the sysctl key.

Examples

# Set vm.swappiness to 5 in /etc/sysctl.conf
- sysctl: name=vm.swappiness value=5 state=present

# Remove kernel.panic entry from /etc/sysctl.conf
- sysctl: name=kernel.panic state=absent sysctl_file=/etc/sysctl.conf

# Set kernel.panic to 3 in /tmp/test_sysctl.conf
- sysctl: name=kernel.panic value=3 sysctl_file=/tmp/test_sysctl.conf reload=no

# Set ip fowarding on in /proc and do not reload the sysctl file
- sysctl: name="net.ipv4.ip_forward" value=1 sysctl_set=yes

# Set ip forwarding on in /proc and in the sysctl file and reload if necessary
- sysctl: name="net.ipv4.ip_forward" value=1 sysctl_set=yes state=present reload=yes