cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Tweak sysctl docs so they'll web-render

Browse source
This commit is contained in:
Michael DeHaan 2013-01-26 12:58:12 -05:00
parent ae176d5310
commit cc53b8ae95
1 changed files with 11 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
sysctl
View file

@ -24,47 +24,43 @@ DOCUMENTATION = '''
module: sysctl module: sysctl
short_description: Permit to handle sysctl.conf entries short_description: Permit to handle sysctl.conf entries
description: description:
- This module handle the entries in C(/etc/sysctl.conf), - This module manipulates sysctl entries and performs a I(/sbin/sysctl -p) after changing them.
and perform a I(/sbin/sysctl -p) after any change
version_added: "0.6" version_added: "0.6"
options: options:
name: name:
description: description:
- | - "this is the short path, decimal seperated, to the sysctl entry, ex: C(vm.swappiness)"
also known as "key",
this is the short path, point separated to the sysctl entry eg: C(vm.swappiness)"
required: true required: true
default: null default: null
aliases: [ 'key' ] aliases: [ 'key' ]
value: value:
description: description:
- "value to affect to the sysctl entry, to not provide if state=absent" - set the sysctl value to this entry
required: false required: false
default: null default: null
aliases: [ 'val' ] aliases: [ 'val' ]
state: state:
description: description:
- state=present the entry is added if not exist, or updated if exist - whether the entry should be present or absent
state=absent the entry is removed if exist
choices: [ "present", "absent" ] choices: [ "present", "absent" ]
default: present default: present
checks: checks:
description: description:
- C(checks)=I(none) no smart/facultative checks will be made - if C(checks)=I(none) no smart/facultative checks will be made
C(checks)=I(before) some checks performed before any update (ie. does the sysctl key is writable ?) - if C(checks)=I(before) some checks performed before any update (ie. does the sysctl key is writable ?)
C(checks)=I(after) some checks performed after an update (ie. does kernel give back the setted value ?) - if C(checks)=I(after) some checks performed after an update (ie. does kernel give back the setted value ?)
C(checks)=I(both) all the smart checks I(before and after) are performed - if C(checks)=I(both) all the smart checks I(before and after) are performed
choices: [ "none", "before", "after", "both" ] choices: [ "none", "before", "after", "both" ]
default: both default: both
reload: reload:
description: description:
- C(reload=yes) perform a I(/sbin/sysctl -p) if C(sysctl_file) updated ! - if C(reload=yes), performs a I(/sbin/sysctl -p) if the C(sysctl_file) is updated
C(reload=no) do not reload I(sysctl) even if C(sysctl_file) updated ! - if C(reload=no), does not reload I(sysctl) even if the C(sysctl_file) is updated
choices: [ yes, no ] choices: [ yes, no ]
default: yes default: yes
sysctl_file: sysctl_file:
description: description:
- specify the absolute path to C(/etc/sysctl.conf) - specifies the absolute path to C(sysctl.conf), if not /etc/sysctl.conf
required: false required: false
default: /etc/sysctl.conf default: /etc/sysctl.conf
examples: examples: