From 2e3ad2b80ad766102aeea4fb578178a89460d230 Mon Sep 17 00:00:00 2001 From: "muszynski@so1.net" Date: Sun, 4 Oct 2015 14:24:07 +0200 Subject: [PATCH] description for the get_url module describing checksum verification before file download --- lib/ansible/modules/network/basics/get_url.py | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/lib/ansible/modules/network/basics/get_url.py b/lib/ansible/modules/network/basics/get_url.py index f1ac527a22..3e3001bdd5 100644 --- a/lib/ansible/modules/network/basics/get_url.py +++ b/lib/ansible/modules/network/basics/get_url.py @@ -78,13 +78,17 @@ options: default: null checksum: description: - - 'If a checksum is passed to this parameter, the digest of the + - If a checksum is passed to this parameter, the digest of the destination file will be calculated after it is downloaded to ensure its integrity and verify that the transfer completed successfully. Format: :, e.g.: checksum="sha256:shagoeshere" If you worry about portability, only the sha1 algorithm is available on all platforms and python versions. The third party hashlib - library can be installed for access to additional algorithms.' + library can be installed for access to additional algorithms. + Additionaly, if a checksum is passed to this parameter, and the file exist under + the C(dest) location, the destination_checksum would be calculated, and if + checksum equals destination_checksum, the file download would be skipped + (unless C(force) is true). version_added: "2.0" required: false default: null