docs: def validate_results(self, results, checks=None):
          '''
          Valdiate results from the Anisble Run.
          '''
          results['status'] = 'PASS'
          failed_hosts = []
  
          ###################################################
          # First validation is to make sure connectivity to
          # all the hosts was ok.
          ###################################################
          if results['dark']:
              print "Host connectivity issues on %s",
              results['dark'].keys()
              failed_hosts.append(results['dark'].keys())
              results['status'] = 'FAIL'
  
          ##################################################
          # Now look for status 'failed'
          ##################################################
          for node in results['contacted'].keys():
              if 'failed' in results['contacted'][node]:
                  if results['contacted'][node]['failed'] is True:
                      results['status'] = 'FAIL'
  
          #################################################
          # Check for the return code 'rc' for each host.
          #################################################
          for node in results['contacted'].keys():
              rc = results['contacted'][node].get('rc', None)
              if rc is not None and rc != 0:
                  print "Operation 'return code' %s on host %s" % \
                      (results['contacted'][node]['rc'], node)
                  failed_hosts.append(node)
                  results['status'] = 'FAIL'
  
          ##################################################
          # Additional checks. If passed is a list of key/value
          # pairs that should be matched.
          ##################################################
          if checks is None:
              #print "No additional checks validated"
              return results, failed_hosts
  
          for check in checks:
              key = check.keys()[0]
              value = check.values()[0]
              for node in results['contacted'].keys():
                  if key in results['contacted'][node].keys():
                      if results['contacted'][node][key] != value:
                          failed_hosts.append(node)
                          results['status'] = 'FAIL'
  
          return (results, failed_hosts)