ANSIBLE.SYSCTL(3)               ANSIBLE MODULES              ANSIBLE.SYSCTL(3)



NAME
       sysctl - Manage entries in sysctl.conf.

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

OPTIONS
       checks If none, no smart/facultative checks will be made. If before,
              some checks are performed before any update (i.e. is the sysctl
              key writable?). If after, some checks are performed after an
              update (i.e. does kernel return the set value?). If both, all of
              the smart checks (before and after) are performed.  Choices:
              none,before,after,both. (default: both)

       name   The dot-separated path (aka key) specifying the sysctl
              variable.(required)

       reload 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.  Choices: yes,no. (default: yes)

       state  Whether the entry should be present or absent.  Choices:
              present,absent. (default: present)

       sysctl_file
              Specifies the absolute path to sysctl.conf, if not
              /etc/sysctl.conf. (default: /etc/sysctl.conf)

       value  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, check if the sysctl key
       # seems writable, but do not reload sysctl, and do not check kernel value
       # after (not needed, because the real /etc/sysctl.conf was not updated)
       - sysctl: name=kernel.panic value=3 sysctl_file=/tmp/test_sysctl.conf check=before reload=no



AUTHOR
       David "DaviXX" CHANIAL <david.chanial@gmail.com>

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#sysctl



1.4.5                             2014-02-12                 ANSIBLE.SYSCTL(3)
