code: def list_upgrades(refresh=True, dist_upgrade=True, **kwargs):
      '''
      List all available package upgrades.
  
      refresh
          Whether to refresh the package database before listing upgrades.
          Default: True.
  
      cache_valid_time
  
          .. versionadded:: 2016.11.0
  
          Skip refreshing the package database if refresh has already occurred within
          <value> seconds
  
      dist_upgrade
          Whether to list the upgrades using dist-upgrade vs upgrade.  Default is
          to use dist-upgrade.
  
      CLI Example:
  
      .. code-block:: bash
  
          salt '*' pkg.list_upgrades
      '''
      cache_valid_time = kwargs.pop('cache_valid_time', 0)
      if salt.utils.data.is_true(refresh):
          refresh_db(cache_valid_time)
      return _get_upgradable(dist_upgrade, **kwargsf list_upgrades(refresh=True, dist_upgrade=True, **kwargs):
      '''
      List all available package upgrades.
  
      refresh
          Whether to refresh the package database before listing upgrades.
          Default: True.
  
      cache_valid_time
  
          .. versionadded:: 2016.11.0
  
          Skip refreshing the package database if refresh has already occurred within
          <value> seconds
  
      dist_upgrade
          Whether to list the upgrades using dist-upgrade vs upgrade.  Default is
          to use dist-upgrade.
  
      CLI Example:
  
      .. code-block:: bash
  
          salt '*' pkg.list_upgrades
      '''
      cache_valid_time = kwargs.pop('cache_valid_time', 0)
      if salt.utils.data.is_true(refresh):
          refresh_db(cache_valid_time)
      return _get_upgradable(dist_upgrade, **kwargs)
docs: List all available package upgrades.
  
      refresh
          Whether to refresh the package database before listing upgrades.
          Default: True.
  
      cache_valid_time
  
          .. versionadded:: 2016.11.0
  
          Skip refreshing the package database if refresh has already occurred within
          <value> seconds
  
      dist_upgrade
          Whether to list the upgrades using dist-upgrade vs upgrade.  Default is
          to use dist-upgrade.
  
      CLI Example:
  
      .. code-block:: bash
  
          salt '*' pkg.list_upgrades