docs: def extend_env(conn, arguments):
      """
      get the remote environment's env so we can explicitly add the path without
      wiping out everything
      """
      # retrieve the remote environment variables for the host
      try:
          result = conn.gateway.remote_exec("import os; channel.send(os.environ.copy())")
          env = result.receive()
      except Exception:
          conn.logger.exception('failed to retrieve the remote environment variables')
          env = {}
  
      # get the $PATH and extend it (do not overwrite)
      path = env.get('PATH', '')
      env['PATH'] = path + '/usr/local/bin:/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/sbin'
      arguments['env'] = env
      if arguments.get('extend_env'):
          for key, value in arguments['extend_env'].items():
              arguments['env'][key] = value
          arguments.pop('extend_env')
      return arguments