From 84eb92d13d9310d7975f3c9e014656227e654013 Mon Sep 17 00:00:00 2001 From: Major Hayden Date: Wed, 3 Oct 2018 12:04:25 -0500 Subject: [PATCH] Docs: Cleanup selinux_permissive module docs (#46351) Update the selinux_permissive instructions and add a comment to the provided example. Signed-off-by: Major Hayden --- .../modules/system/selinux_permissive.py | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/lib/ansible/modules/system/selinux_permissive.py b/lib/ansible/modules/system/selinux_permissive.py index d93c281fd14..d7f4a8bd123 100644 --- a/lib/ansible/modules/system/selinux_permissive.py +++ b/lib/ansible/modules/system/selinux_permissive.py @@ -19,36 +19,37 @@ DOCUMENTATION = ''' module: selinux_permissive short_description: Change permissive domain in SELinux policy description: - - Add and remove domain from the list of permissive domain. + - Add and remove a domain from the list of permissive domains. version_added: "2.0" options: domain: description: - - "the domain that will be added or removed from the list of permissive domains" + - The domain that will be added or removed from the list of permissive domains. required: true permissive: description: - - "indicate if the domain should or should not be set as permissive" + - Indicate if the domain should or should not be set as permissive. required: true type: bool no_reload: description: - - "automatically reload the policy after a change" - - "default is set to 'false' as that's what most people would want after changing one domain" - - "Note that this doesn't work on older version of the library (example EL 6), the module will silently ignore it in this case" + - Disable reloading of the SELinux policy after making change to a domain's permissive setting. + - The default is C(no), which causes policy to be reloaded when a domain changes state. + - Reloading the policy does not work on older versions of the C(policycoreutils-python) library, for example in EL 6." type: bool default: 'no' store: description: - - "name of the SELinux policy store to use" + - "Name of the SELinux policy store to use." notes: - - Requires a version of SELinux recent enough ( ie EL 6 or newer ) + - Requires a recent version of SELinux and C(policycoreutils-python) (EL 6 or newer). requirements: [ policycoreutils-python ] author: Michael Scherer (@mscherer) ''' EXAMPLES = ''' -- selinux_permissive: +- name: Change the httpd_t domain to permissive + selinux_permissive: name: httpd_t permissive: true '''