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 only_if.

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 only_if together

       fail: msg="The system may not be provisioned according to the CMDB status."
           only_if: "'$cmdb_status' != 'to-be-staged'"


AUTHOR
       Dag Wieers

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



0.9                               2012-11-30                   ANSIBLE.FAIL(3)
