xref: /linux/net/ethtool/common.h (revision dad4d4b92a9b9f0edb8c66deda049da1b62f6089)
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 	}
117 	return false;
118 }
119 
120 /**
121  * ethtool_ioctl_needs_rtnl() - does this legacy ioctl cmd need rtnl_lock?
122  * @dev: target device
123  * @ethcmd: ETHTOOL_* ioctl command value
124  *
125  * Return: true if @ethcmd is a command for which @dev has opted-in to
126  * keeping rtnl_lock held across the call (via op_needs_rtnl).
127  */
128 static inline bool
129 ethtool_ioctl_needs_rtnl(const struct net_device *dev, u32 ethcmd)
130 {
131 	const struct ethtool_ops *ops = dev->ethtool_ops;
132 
133 	switch (ethcmd) {
134 	case ETHTOOL_GLINKSETTINGS:
135 	case ETHTOOL_GSET:
136 	case ETHTOOL_SLINKSETTINGS:
137 	case ETHTOOL_SSET:
138 		return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_LINKSETTINGS;
139 	case ETHTOOL_SPFLAGS:
140 		return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SPFLAGS;
141 	case ETHTOOL_SRINGPARAM:
142 		return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SRINGPARAM;
143 	case ETHTOOL_SCHANNELS:
144 		return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SCHANNELS;
145 	case ETHTOOL_SCOALESCE:
146 		return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SCOALESCE;
147 	case ETHTOOL_GPAUSEPARAM:
148 		return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_GPAUSEPARAM;
149 	case ETHTOOL_SPAUSEPARAM:
150 		return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_SPAUSEPARAM;
151 	case ETHTOOL_SRSSH:
152 	case ETHTOOL_SRXFH:
153 	case ETHTOOL_SRXFHINDIR:
154 		return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_RSS;
155 	}
156 	return false;
157 }
158 
159 #if IS_ENABLED(CONFIG_ETHTOOL_NETLINK)
160 void ethtool_rss_notify(struct net_device *dev, u32 type, u32 rss_context);
161 #else
162 static inline void
163 ethtool_rss_notify(struct net_device *dev, u32 type, u32 rss_context)
164 {
165 }
166 #endif
167 
168 #endif /* _ETHTOOL_COMMON_H */
169