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
        

        Table Of Contents

        Previous topic

        setup - Gathers facts about remote hosts

        Next topic

        ufw - Manage firewall with UFW