docs: def run(self, conn, tmp, module_name, module_args, inject):
          ''' run the pause actionmodule '''
          hosts = ', '.join(self.runner.host_set)
          args = parse_kv(template(self.runner.basedir, module_args, inject))
  
          # Are 'minutes' or 'seconds' keys that exist in 'args'?
          if 'minutes' in args or 'seconds' in args:
              try:
                  if 'minutes' in args:
                      self.pause_type = 'minutes'
                      # The time() command operates in seconds so we need to
                      # recalculate for minutes=X values.
                      self.seconds = int(args['minutes']) * 60
                  else:
                      self.pause_type = 'seconds'
                      self.seconds = int(args['seconds'])
                      self.duration_unit = 'seconds'
              except ValueError, e:
                  raise ae("non-integer value given for prompt duration:\n%s" % str(e))
          # Is 'prompt' a key in 'args'?
          elif 'prompt' in args:
              self.pause_type = 'prompt'
              self.prompt = "[%s]\n%s: " % (hosts, args['prompt'])
          # Is 'args' empty, then this is the default prompted pause
          elif len(args.keys()) == 0:
              self.pause_type = 'prompt'
              self.prompt = "[%s]\nPress enter to continue: " % hosts
          # I have no idea what you're trying to do. But it's so wrong.
          else:
              raise ae("invalid pause type given. must be one of: %s" % \
                           ", ".join(self.PAUSE_TYPES))
  
          vv("created 'pause' ActionModule: pause_type=%s, duration_unit=%s, calculated_seconds=%s, prompt=%s" % \
                  (self.pause_type, self.duration_unit, self.seconds, self.prompt))
  
          ########################################################################
          # Begin the hard work!
          try:
              self._start()
              if not self.pause_type == 'prompt':
                  print "[%s]\nPausing for %s seconds" % (hosts, self.seconds)
                  time.sleep(self.seconds)
              else:
                  # Clear out any unflushed buffered input which would
                  # otherwise be consumed by raw_input() prematurely.
                  tcflush(sys.stdin, TCIFLUSH)
                  raw_input(self.prompt)
          except KeyboardInterrupt:
              while True:
                  print '\nAction? (a)bort/(c)ontinue: '
                  c = getch()
                  if c == 'c':
                      # continue playbook evaluation
                      break
                  elif c == 'a':
                      # abort further playbook evaluation
                      raise ae('user requested abort!')
          finally:
              self._stop()
  
          return ReturnData(conn=conn, result=self.result)