mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
74 lines
2.2 KiB
ReStructuredText
74 lines
2.2 KiB
ReStructuredText
.. _lineinfile:
|
|
|
|
lineinfile
|
|
``````````````````````````````
|
|
|
|
.. versionadded:: 0.7
|
|
|
|
This module will search a file for a line, and ensure that it is present or absent.
|
|
This is primarily useful when you want to change a single line in a file only. For other cases, see the ``copy`` or ``template`` modules.
|
|
|
|
.. raw:: html
|
|
|
|
<table>
|
|
<tr>
|
|
<th class="head">parameter</th>
|
|
<th class="head">required</th>
|
|
<th class="head">default</th>
|
|
<th class="head">choices</th>
|
|
<th class="head">comments</th>
|
|
</tr>
|
|
<tr>
|
|
<td>state</td>
|
|
<td>no</td>
|
|
<td>present</td>
|
|
<td><ul><li>present</li><li>absent</li></ul></td>
|
|
<td>Whether the line should be there or not.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>name</td>
|
|
<td>yes</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>The file to modify</td>
|
|
</tr>
|
|
<tr>
|
|
<td>insertafter</td>
|
|
<td>no</td>
|
|
<td>EOF</td>
|
|
<td><ul><li>BOF</li><li>EOF</li></ul></td>
|
|
<td>Used with <code>state=present</code>. If specified, the line will be inserted after the specified regular expression. Two special values are available; <code>BOF</code> for inserting the line at the beginning of the file, and <code>EOF</code> for inserting the line at the end of the file.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>regexp</td>
|
|
<td>yes</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>The regular expression to look for in the file. For <code>state=present</code>, the pattern to replace. For <code>state=absent</code>, the pattern of the line to remove.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>line</td>
|
|
<td>no</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>Required for <code>state=present</code>. The line to insert/replace into the file. Must match the value given to <code>regexp</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>backup</td>
|
|
<td>no</td>
|
|
<td></td>
|
|
<td><ul></ul></td>
|
|
<td>Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly.</td>
|
|
</tr>
|
|
</table>
|
|
|
|
.. raw:: html
|
|
|
|
<p><pre>
|
|
lineinfile name=/etc/selinux/config regexp=^SELINUX= line=SELINUX=disabled
|
|
</pre></p>
|
|
<p><pre>
|
|
lineinfile name=/etc/sudoers state=absent regexp="^%wheel"
|
|
</pre></p>
|
|
<br/>
|
|
|