1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 3 #ifndef _ETHTOOL_COMMON_H 4 #define _ETHTOOL_COMMON_H 5 6 #include <linux/netdevice.h> 7 #include <linux/ethtool.h> 8 9 #define ETHTOOL_DEV_FEATURE_WORDS DIV_ROUND_UP(NETDEV_FEATURE_COUNT, 32) 10 11 /* compose link mode index from speed, type and duplex */ 12 #define ETHTOOL_LINK_MODE(speed, type, duplex) \ 13 ETHTOOL_LINK_MODE_ ## speed ## base ## type ## _ ## duplex ## _BIT 14 15 #define __SOF_TIMESTAMPING_CNT (const_ilog2(SOF_TIMESTAMPING_LAST) + 1) 16 #define __HWTSTAMP_FLAG_CNT (const_ilog2(HWTSTAMP_FLAG_LAST) + 1) 17 18 struct genl_info; 19 struct hwtstamp_provider_desc; 20 21 extern const char 22 netdev_features_strings[NETDEV_FEATURE_COUNT][ETH_GSTRING_LEN]; 23 extern const char 24 rss_hash_func_strings[ETH_RSS_HASH_FUNCS_COUNT][ETH_GSTRING_LEN]; 25 extern const char 26 tunable_strings[__ETHTOOL_TUNABLE_COUNT][ETH_GSTRING_LEN]; 27 extern const char 28 phy_tunable_strings[__ETHTOOL_PHY_TUNABLE_COUNT][ETH_GSTRING_LEN]; 29 extern const char link_mode_names[][ETH_GSTRING_LEN]; 30 extern const char netif_msg_class_names[][ETH_GSTRING_LEN]; 31 extern const char wol_mode_names[][ETH_GSTRING_LEN]; 32 extern const char sof_timestamping_names[][ETH_GSTRING_LEN]; 33 extern const char ts_tx_type_names[][ETH_GSTRING_LEN]; 34 extern const char ts_rx_filter_names[][ETH_GSTRING_LEN]; 35 extern const char ts_flags_names[][ETH_GSTRING_LEN]; 36 extern const char udp_tunnel_type_names[][ETH_GSTRING_LEN]; 37 38 int __ethtool_get_link(struct net_device *dev); 39 40 bool convert_legacy_settings_to_link_ksettings( 41 struct ethtool_link_ksettings *link_ksettings, 42 const struct ethtool_cmd *legacy_settings); 43 int ethtool_check_max_channel(struct net_device *dev, 44 struct ethtool_channels channels, 45 struct genl_info *info); 46 struct ethtool_rxfh_context * 47 ethtool_rxfh_ctx_alloc(const struct ethtool_ops *ops, 48 u32 indir_size, u32 key_size); 49 int ethtool_check_rss_ctx_busy(struct net_device *dev, u32 rss_context); 50 int ethtool_rxfh_config_is_sym(u64 rxfh); 51 52 void ethtool_ringparam_get_cfg(struct net_device *dev, 53 struct ethtool_ringparam *param, 54 struct kernel_ethtool_ringparam *kparam, 55 struct netlink_ext_ack *extack); 56 57 int ethtool_get_rx_ring_count(struct net_device *dev); 58 59 int __ethtool_get_ts_info(struct net_device *dev, struct kernel_ethtool_ts_info *info); 60 int ethtool_get_ts_info_by_phc(struct net_device *dev, 61 struct kernel_ethtool_ts_info *info, 62 struct hwtstamp_provider_desc *hwprov_desc); 63 int ethtool_net_get_ts_info_by_phc(struct net_device *dev, 64 struct kernel_ethtool_ts_info *info, 65 struct hwtstamp_provider_desc *hwprov_desc); 66 struct phy_device * 67 ethtool_phy_get_ts_info_by_phc(struct net_device *dev, 68 struct kernel_ethtool_ts_info *info, 69 struct hwtstamp_provider_desc *hwprov_desc); 70 bool net_support_hwtstamp_qualifier(struct net_device *dev, 71 enum hwtstamp_provider_qualifier qualifier); 72 73 extern const struct ethtool_phy_ops *ethtool_phy_ops; 74 extern const struct ethtool_pse_ops *ethtool_pse_ops; 75 76 int ethtool_get_module_info_call(struct net_device *dev, 77 struct ethtool_modinfo *modinfo); 78 int ethtool_get_module_eeprom_call(struct net_device *dev, 79 struct ethtool_eeprom *ee, u8 *data); 80 81 bool __ethtool_dev_mm_supported(struct net_device *dev); 82 83 /** 84 * ethtool_nl_msg_needs_rtnl() - does this Netlink cmd need rtnl_lock? 85 * @dev: target device 86 * @cmd: ETHTOOL_MSG_* Netlink command value 87 * 88 * Return: true if @cmd is a command for which @dev has opted-in to 89 * keeping rtnl_lock held across the call (via op_needs_rtnl). 90 */ 91 static inline bool 92 ethtool_nl_msg_needs_rtnl(const struct net_device *dev, u8 cmd) 93 { 94 const struct ethtool_ops *ops = dev->ethtool_ops; 95 96 switch (cmd) { 97 case ETHTOOL_MSG_LINKINFO_GET: 98 case ETHTOOL_MSG_LINKINFO_SET: 99 case ETHTOOL_MSG_LINKMODES_GET: 100 case ETHTOOL_MSG_LINKMODES_SET: 101 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_LINKSETTINGS; 102 case ETHTOOL_MSG_PRIVFLAGS_SET: 103 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SPFLAGS; 104 case ETHTOOL_MSG_RINGS_SET: 105 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SRINGPARAM; 106 case ETHTOOL_MSG_CHANNELS_SET: 107 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SCHANNELS; 108 case ETHTOOL_MSG_COALESCE_SET: 109 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SCOALESCE; 110 case ETHTOOL_MSG_PAUSE_GET: 111 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_GPAUSEPARAM; 112 case ETHTOOL_MSG_PAUSE_SET: 113 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SPAUSEPARAM; 114 case ETHTOOL_MSG_RSS_SET: 115 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_RSS; 116 case ETHTOOL_MSG_TSCONFIG_GET: 117 case ETHTOOL_MSG_TSCONFIG_SET: 118 /* tsconfig calls ndos (ndo_hwtstamp_set/get), not ethtool ops. 119 * Also, there is no corresponding ethtool ioctl, therefore 120 * these cases are Netlink-only. 121 */ 122 return true; 123 } 124 return false; 125 } 126 127 /** 128 * ethtool_ioctl_needs_rtnl() - does this legacy ioctl cmd need rtnl_lock? 129 * @dev: target device 130 * @ethcmd: ETHTOOL_* ioctl command value 131 * 132 * Return: true if @ethcmd is a command for which @dev has opted-in to 133 * keeping rtnl_lock held across the call (via op_needs_rtnl). 134 */ 135 static inline bool 136 ethtool_ioctl_needs_rtnl(const struct net_device *dev, u32 ethcmd) 137 { 138 const struct ethtool_ops *ops = dev->ethtool_ops; 139 140 switch (ethcmd) { 141 case ETHTOOL_GLINKSETTINGS: 142 case ETHTOOL_GSET: 143 case ETHTOOL_SLINKSETTINGS: 144 case ETHTOOL_SSET: 145 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_LINKSETTINGS; 146 case ETHTOOL_SPFLAGS: 147 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SPFLAGS; 148 case ETHTOOL_SRINGPARAM: 149 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SRINGPARAM; 150 case ETHTOOL_SCHANNELS: 151 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SCHANNELS; 152 case ETHTOOL_SCOALESCE: 153 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SCOALESCE; 154 case ETHTOOL_GPAUSEPARAM: 155 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_GPAUSEPARAM; 156 case ETHTOOL_SPAUSEPARAM: 157 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SPAUSEPARAM; 158 case ETHTOOL_SRSSH: 159 case ETHTOOL_SRXFH: 160 case ETHTOOL_SRXFHINDIR: 161 return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_RSS; 162 } 163 return false; 164 } 165 166 #if IS_ENABLED(CONFIG_ETHTOOL_NETLINK) 167 void ethtool_rss_notify(struct net_device *dev, u32 type, u32 rss_context); 168 #else 169 static inline void 170 ethtool_rss_notify(struct net_device *dev, u32 type, u32 rss_context) 171 { 172 } 173 #endif 174 175 #endif /* _ETHTOOL_COMMON_H */ 176