# this is a virtual module that is entirely implemented server side

DOCUMENTATION = '''
---
module: raw
short_description: Executes a low-down and dirty SSH command
options: {}
description: 
     - Executes a low-down and dirty SSH command, not going through the module
       subsystem. This is useful and should only be done in two cases. The
       first case is installing C(python-simplejson) on older (Python 2.4 and
       before) hosts that need it as a dependency to run modules, since nearly
       all core modules require it. Another is speaking to any devices such as
       routers that do not have any Python installed. In any other case, using
       the M(shell) or M(command) module is much more appropriate. Arguments
       given to M(raw) are run directly through the configured remote shell and
       only output is returned. There is no error detection or change handler
       support for this module
examples:
    - code: ansible newhost.example.com -m raw -a "yum -y install python-simplejson"
      description: Example from C(/usr/bin/ansible) to bootstrap a legacy python 2.4 host
author: Michael DeHaan
'''