docs: def flush(name, table='filter', family='ipv4', **kwargs):
      '''
      .. versionadded:: 2014.1.0
  
      Flush current iptables state
  
      table
          The table that owns the chain that should be modified
  
      family
          Networking family, either ipv4 or ipv6
  
      '''
      ret = {'name': name,
             'changes': {},
             'result': None,
             'comment': ''}
  
      for ignore in _STATE_INTERNAL_KEYWORDS:
          if ignore in kwargs:
              del kwargs[ignore]
  
      if 'chain' not in kwargs:
          kwargs['chain'] = ''
      if __opts__['test']:
          ret['comment'] = 'iptables rules in {0} table {1} chain {2} family needs to be flushed'.format(
              name,
              table,
              family)
          return ret
      if not __salt__['iptables.flush'](table, kwargs['chain'], family):
          ret['changes'] = {'locale': name}
          ret['result'] = True
          ret['comment'] = 'Flush iptables rules in {0} table {1} chain {2} family'.format(
              table,
              kwargs['chain'],
              family
          )
          return ret
      else:
          ret['result'] = False
          ret['comment'] = 'Failed to flush iptables rules'
          return ret