ANSIBLE.FAIL(3)                 ANSIBLE MODULES                ANSIBLE.FAIL(3)



NAME
       fail - Fail with custom message

DESCRIPTION
       This module fails the progress with a custom message. It can be useful
       for bailing out when a certain condition is met using when.

OPTIONS
       msg    The customized message used for failing execution. If omitted,
              fail will simple bail out with a generic message. (default:
              'Failed as requested from task').

EXAMPLES
       # Example playbook using fail and when together
       - fail: msg="The system may not be provisioned according to the CMDB status."
         when: "{{ cmdb_status }} != 'to-be-staged'"



AUTHOR
       Dag Wieers

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#fail



1.4.5                             2014-02-12                   ANSIBLE.FAIL(3)
