From e3343c990a12f47b0921604389ae68388a544f20 Mon Sep 17 00:00:00 2001 From: "patchback[bot]" <45432694+patchback[bot]@users.noreply.github.com> Date: Fri, 4 Aug 2023 14:53:43 +0100 Subject: [PATCH] Update intro_adhoc.rst (#200) (#243) (cherry picked from commit b8493a73518a4397a1909de2a49db9548ad4e767) Co-authored-by: Aditya Putta --- docs/docsite/rst/command_guide/intro_adhoc.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/docsite/rst/command_guide/intro_adhoc.rst b/docs/docsite/rst/command_guide/intro_adhoc.rst index 2171f292d1e..562bfca5cb9 100644 --- a/docs/docsite/rst/command_guide/intro_adhoc.rst +++ b/docs/docsite/rst/command_guide/intro_adhoc.rst @@ -198,6 +198,17 @@ Facts represent discovered variables about a system. You can use facts to implem You can also filter this output to display only certain facts, see the :ref:`ansible.builtin.setup ` module documentation for details. +Check mode +---------- + +In check mode, Ansible does not make any changes to remote systems. Ansible prints the commands only. It does not run the commands. + +.. code-block:: bash + + $ ansible all -m copy -a "content=foo dest=/root/bar.txt" -C + +Enabling check mode (``-C`` or ``--check``) in the above command means Ansible does not actually create or update the ``/root/bar.txt`` file on any remote systems. + Patterns and ad-hoc commands ----------------------------