@ -1661,8 +1667,92 @@ service name=httpd state=reloaded
service name=foo pattern=/usr/bin/foo state=started</pre>
</div>
</div>
<divclass="section"id="seboolean">
<spanid="id27"></span><h2><aclass="toc-backref"href="#contents">seboolean</a><aclass="headerlink"href="#seboolean"title="Permalink to this headline">¶</a></h2>
<pclass="versionadded">
<spanclass="versionmodified">New in version 0.7.</span></p>
<p>Toggles SELinux booleans.</p>
<tableborder="1"class="docutils">
<colgroup>
<colwidth="16%"/>
<colwidth="8%"/>
<colwidth="17%"/>
<colwidth="60%"/>
</colgroup>
<theadvalign="bottom">
<trclass="row-odd"><thclass="head">parameter</th>
<thclass="head">required</th>
<thclass="head">default</th>
<thclass="head">comments</th>
</tr>
</thead>
<tbodyvalign="top">
<trclass="row-even"><td>name</td>
<td>yes</td>
<td> </td>
<td>name of the boolean to configure</td>
</tr>
<trclass="row-odd"><td>persistent</td>
<td>no</td>
<td>no</td>
<td>set to ‘yes’ if the boolean setting should survive a reboot</td>
</tr>
<trclass="row-even"><td>state</td>
<td>yes</td>
<td> </td>
<td>desired boolean value. ‘true’ or ‘false’.</td>
</tr>
</tbody>
</table>
<p>Example from Ansible <aclass="reference internal"href="playbooks.html"><em>Playbooks</em></a>:</p>
<spanid="id28"></span><h2><aclass="toc-backref"href="#contents">selinux</a><aclass="headerlink"href="#selinux"title="Permalink to this headline">¶</a></h2>
<pclass="versionadded">
<spanclass="versionmodified">New in version 0.7.</span></p>
<p>Configures the SELinux mode and policy. A reboot may be required after usage. Ansible will not issue this reboot but
will let you know when it is required.</p>
<tableborder="1"class="docutils">
<colgroup>
<colwidth="16%"/>
<colwidth="8%"/>
<colwidth="17%"/>
<colwidth="60%"/>
</colgroup>
<theadvalign="bottom">
<trclass="row-odd"><thclass="head">parameter</th>
<thclass="head">required</th>
<thclass="head">default</th>
<thclass="head">comments</th>
</tr>
</thead>
<tbodyvalign="top">
<trclass="row-even"><td>policy</td>
<td>yes</td>
<td> </td>
<td>name of the SELinux policy to use (example: ‘targetted’)</td>
</tr>
<trclass="row-odd"><td>state</td>
<td>yes</td>
<td> </td>
<td>the SELinux mode. ‘enforcing’, ‘permissive’, or ‘disabled’</td>
</tr>
<trclass="row-even"><td>conf</td>
<td>no</td>
<td>/etc/selinux/config</td>
<td>path to the SELinux configuration file, if non-standard</td>
</tr>
</tbody>
</table>
<p>Example from Ansible <aclass="reference internal"href="playbooks.html"><em>Playbooks</em></a>:</p>
<spanid="id27"></span><h2><aclass="toc-backref"href="#contents">setup</a><aclass="headerlink"href="#setup"title="Permalink to this headline">¶</a></h2>
<spanid="id29"></span><h2><aclass="toc-backref"href="#contents">setup</a><aclass="headerlink"href="#setup"title="Permalink to this headline">¶</a></h2>
<p>This module is automatically called by playbooks to gather useful variables about remote hosts that can be used
in playbooks. It can also be executed directly by /usr/bin/ansible to check what variables are available
to a host.</p>
@ -1744,7 +1834,7 @@ on your remote systems.</p>
</div>
</div>
<divclass="section"id="shell">
<spanid="id28"></span><h2><aclass="toc-backref"href="#contents">shell</a><aclass="headerlink"href="#shell"title="Permalink to this headline">¶</a></h2>
<spanid="id30"></span><h2><aclass="toc-backref"href="#contents">shell</a><aclass="headerlink"href="#shell"title="Permalink to this headline">¶</a></h2>
<p>The shell module takes the command name followed by a list of
arguments, space delimited. It is almost exactly like the command module
but runs the command through the user’s configured shell on the remote node.</p>
@ -1794,7 +1884,7 @@ your best judgement.</p>
</div>
</div>
<divclass="section"id="subversion">
<spanid="id29"></span><h2><aclass="toc-backref"href="#contents">subversion</a><aclass="headerlink"href="#subversion"title="Permalink to this headline">¶</a></h2>
<spanid="id31"></span><h2><aclass="toc-backref"href="#contents">subversion</a><aclass="headerlink"href="#subversion"title="Permalink to this headline">¶</a></h2>
<pclass="versionadded">
<spanclass="versionmodified">New in version 0.7.</span></p>
<p>Deploys a subversion repository.</p>
@ -1836,7 +1926,7 @@ discarded. If no, this module will fail if it encounters modified files.</td>
</div>
</div>
<divclass="section"id="supervisorctl">
<spanid="id30"></span><h2><aclass="toc-backref"href="#contents">supervisorctl</a><aclass="headerlink"href="#supervisorctl"title="Permalink to this headline">¶</a></h2>
<spanid="id32"></span><h2><aclass="toc-backref"href="#contents">supervisorctl</a><aclass="headerlink"href="#supervisorctl"title="Permalink to this headline">¶</a></h2>
<pclass="versionadded">
<spanclass="versionmodified">New in version 0.7.</span></p>
<p>Manage the state of a program or group of programs running via Supervisord</p>
@ -1872,7 +1962,7 @@ discarded. If no, this module will fail if it encounters modified files.</td>
</div>
</div>
<divclass="section"id="template">
<spanid="id31"></span><h2><aclass="toc-backref"href="#contents">template</a><aclass="headerlink"href="#template"title="Permalink to this headline">¶</a></h2>
<spanid="id33"></span><h2><aclass="toc-backref"href="#contents">template</a><aclass="headerlink"href="#template"title="Permalink to this headline">¶</a></h2>
<p>Templates a file out to a remote server.</p>
<tableborder="1"class="docutils">
<colgroup>
@ -1912,7 +2002,7 @@ a relative or absolute path.</td>
</div>
</div>
<divclass="section"id="user">
<spanid="id32"></span><h2><aclass="toc-backref"href="#contents">user</a><aclass="headerlink"href="#user"title="Permalink to this headline">¶</a></h2>
<spanid="id34"></span><h2><aclass="toc-backref"href="#contents">user</a><aclass="headerlink"href="#user"title="Permalink to this headline">¶</a></h2>
<p>Creates user accounts, manipulates existing user accounts, and removes user accounts.</p>
<tableborder="1"class="docutils">
<colgroup>
@ -2010,8 +2100,63 @@ user name=mdehaan groups=wheel,skynet
user name=mdehaan state=absent force=yes</pre>
</div>
</div>
<divclass="section"id="wait-for">
<spanid="id35"></span><h2><aclass="toc-backref"href="#contents">wait_for</a><aclass="headerlink"href="#wait-for"title="Permalink to this headline">¶</a></h2>
<pclass="versionadded">
<spanclass="versionmodified">New in version 0.7.</span></p>
<p>Waits for a given port to become accessible (or inaccessible) on a local or remote server.</p>
<p>This is useful for when services are not immediately available after their init scripts return – which is true of certain
Java application servers. It is also useful when starting guests with the virt module and
needing to pause until they are ready.</p>
<tableborder="1"class="docutils">
<colgroup>
<colwidth="17%"/>
<colwidth="9%"/>
<colwidth="9%"/>
<colwidth="65%"/>
</colgroup>
<theadvalign="bottom">
<trclass="row-odd"><thclass="head">parameter</th>
<thclass="head">required</th>
<thclass="head">default</th>
<thclass="head">comments</th>
</tr>
</thead>
<tbodyvalign="top">
<trclass="row-even"><td>host</td>
<td>no</td>
<td>127.0.0.1</td>
<td>hostname or IP to wait for</td>
</tr>
<trclass="row-odd"><td>timeout</td>
<td>no</td>
<td>300</td>
<td>maximum number of seconds to wait</td>
</tr>
<trclass="row-even"><td>delay</td>
<td>no</td>
<td>0</td>
<td>number of seconds to wait before starting to poll</td>
</tr>
<trclass="row-odd"><td>port</td>
<td>yes</td>
<td> </td>
<td>port to poll for openness or closedness</td>
</tr>
<trclass="row-even"><td>state</td>
<td>no</td>
<td>started</td>
<td>either ‘started’, or ‘stopped’ depending on whether the module should poll
for the port being open or closed.</td>
</tr>
</tbody>
</table>
<p>Example from Ansible <aclass="reference internal"href="playbooks.html"><em>Playbooks</em></a>:</p>
Michael DeHaan
12 years ago