summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatt Martz <matt@sivel.net>2016-01-22 09:59:38 -0600
committerMatt Martz <matt@sivel.net>2016-01-22 11:29:35 -0600
commit3f232beb0a669fd2bad75ec6c87a2227d986c5ce (patch)
treeed04575b165f99313f917dc0a5e9563d2329b690
parent907b7f7cf4c97a720391a82eb65c2705a259614e (diff)
downloadansible-modules-core-3f232beb0a669fd2bad75ec6c87a2227d986c5ce.tar.gz
Add note about precautions of using become with fetch. Addresses https://github.com/ansible/ansible/issues/14064
-rw-r--r--files/fetch.py7
1 files changed, 7 insertions, 0 deletions
diff --git a/files/fetch.py b/files/fetch.py
index d0b1371c..4ca191b8 100644
--- a/files/fetch.py
+++ b/files/fetch.py
@@ -68,6 +68,13 @@ requirements: []
author:
- "Ansible Core Team"
- "Michael DeHaan"
+notes:
+ - When running fetch with C(become), the M(slurp) module will also be
+ used to fetch the contents of the file for determining the remote
+ checksum. This effectively doubles the transfer size, and
+ depending on the file size can consume all available memory on the
+ remote or local hosts causing a C(MemoryError). Due to this it is
+ advisable to run this module without C(become) whenever possible.
'''
EXAMPLES = '''