From d79d57fbfeafe5a4c3994e2fd176cb1511c28599 Mon Sep 17 00:00:00 2001
From: Yves Dorfsman <yves@zioup.com>
Date: Sat, 2 Mar 2013 11:04:48 -0700
Subject: [PATCH] Added a fail_on_missing option to fetch.

---
 fetch | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/fetch b/fetch
index 9b789ccdc49..72ae55cc5a7 100644
--- a/fetch
+++ b/fetch
@@ -7,8 +7,9 @@ short_description: Fetches a file from remote nodes
 description:
      - This module works like M(copy), but in reverse. It is used for fetching
        files from remote machines and storing them locally in a file tree,
-       organized by hostname. Note that if the source file is missing, it
-       returns status=ok.
+       organized by hostname. Note that this module was originally written to
+       transfer log files that were not necessarily present, therefore, by
+       default, if the source file is missing, it does not fail ; 
 version_added: "0.2"
 options:
   src:
@@ -26,6 +27,12 @@ options:
         C(/backup/host.example.com/etc/profile)
     required: true
     default: null
+  fail_on_missing:
+    description:
+      - Makes it fails when the source file is missing.
+    required: false
+    choices: [ "yes", "no" ]
+    default: "no"
 examples:
    - code: "fetch: src=/var/log/messages dest=/home/logtree"
      description: "Example from Ansible Playbooks"