From e12f3d40290592aa4a9fe52c14a827e07e8fd53c Mon Sep 17 00:00:00 2001 From: Romeo Theriault Date: Sun, 9 Sep 2012 18:12:27 -1000 Subject: [PATCH] add backup option to the copy modules docs --- rst/modules/copy.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/rst/modules/copy.rst b/rst/modules/copy.rst index 41811997d0c..3b534d850ee 100644 --- a/rst/modules/copy.rst +++ b/rst/modules/copy.rst @@ -15,9 +15,16 @@ module. +--------------------+----------+---------+----------------------------------------------------------------------------+ | dest | yes | | Remote absolute path where the file should end up | +--------------------+----------+---------+----------------------------------------------------------------------------+ +| backup | no | no | Create a backup file including the timestamp information so you can | +| | | | get the original file back if you somehow clobbered it incorrectly. | ++--------------------+----------+---------+----------------------------------------------------------------------------+ | OTHERS | | | All arguments the file module takes are also supported | +--------------------+----------+---------+----------------------------------------------------------------------------+ Example action from Ansible :doc:`playbooks`:: copy src=/srv/myfiles/foo.conf dest=/etc/foo.conf owner=foo group=foo mode=0644 + +Copy a new ntp.conf file into place, backing up the original if it differs from the copied version:: + + copy src=/srv/myfiles/ntp.conf dest=/etc/ntp.conf owner=root group=root mode=644 backup=yes