xref: /linux/net/ethtool/common.h (revision 45079e00133ee78fd216ccc4285534044ea69173)
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_LINKMODES_GET:
99 		return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_LINKSETTINGS;
100 	case ETHTOOL_MSG_PAUSE_GET:
101 		return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_GPAUSEPARAM;
102 	}
103 	return false;
104 }
105 
106 /**
107  * ethtool_ioctl_needs_rtnl() - does this legacy ioctl cmd need rtnl_lock?
108  * @dev: target device
109  * @ethcmd: ETHTOOL_* ioctl command value
110  *
111  * Return: true if @ethcmd is a command for which @dev has opted-in to
112  * keeping rtnl_lock held across the call (via op_needs_rtnl).
113  */
114 static inline bool
115 ethtool_ioctl_needs_rtnl(const struct net_device *dev, u32 ethcmd)
116 {
117 	const struct ethtool_ops *ops = dev->ethtool_ops;
118 
119 	switch (ethcmd) {
120 	case ETHTOOL_GLINKSETTINGS:
121 	case ETHTOOL_GSET:
122 		return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_LINKSETTINGS;
123 	case ETHTOOL_GPAUSEPARAM:
124 		return ops->op_needs_rtnl & ETHTOOL_OP_NEEDS_RTNL_GPAUSEPARAM;
125 	}
126 	return false;
127 }
128 
129 #if IS_ENABLED(CONFIG_ETHTOOL_NETLINK)
130 void ethtool_rss_notify(struct net_device *dev, u32 type, u32 rss_context);
131 #else
132 static inline void
133 ethtool_rss_notify(struct net_device *dev, u32 type, u32 rss_context)
134 {
135 }
136 #endif
137 
138 #endif /* _ETHTOOL_COMMON_H */
139