]>
Commit | Line | Data |
---|---|---|
b2441318 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
1da177e4 LT |
2 | /* |
3 | * ethtool.h: Defines for Linux ethtool. | |
4 | * | |
5 | * Copyright (C) 1998 David S. Miller (davem@redhat.com) | |
6 | * Copyright 2001 Jeff Garzik <jgarzik@pobox.com> | |
7 | * Portions Copyright 2001 Sun Microsystems (thockin@sun.com) | |
8 | * Portions Copyright 2002 Intel (eli.kupermann@intel.com, | |
9 | * christopher.leech@intel.com, | |
10 | * scott.feldman@intel.com) | |
59089d8d | 11 | * Portions Copyright (C) Sun Microsystems 2008 |
1da177e4 | 12 | */ |
1da177e4 LT |
13 | #ifndef _LINUX_ETHTOOL_H |
14 | #define _LINUX_ETHTOOL_H | |
15 | ||
3f1ac7a7 | 16 | #include <linux/bitmap.h> |
3a7da39d | 17 | #include <linux/compat.h> |
607ca46e | 18 | #include <uapi/linux/ethtool.h> |
3ae7c0b2 | 19 | |
3a7da39d BH |
20 | #ifdef CONFIG_COMPAT |
21 | ||
22 | struct compat_ethtool_rx_flow_spec { | |
23 | u32 flow_type; | |
127fe533 AD |
24 | union ethtool_flow_union h_u; |
25 | struct ethtool_flow_ext h_ext; | |
26 | union ethtool_flow_union m_u; | |
27 | struct ethtool_flow_ext m_ext; | |
3a7da39d BH |
28 | compat_u64 ring_cookie; |
29 | u32 location; | |
30 | }; | |
31 | ||
32 | struct compat_ethtool_rxnfc { | |
33 | u32 cmd; | |
34 | u32 flow_type; | |
35 | compat_u64 data; | |
36 | struct compat_ethtool_rx_flow_spec fs; | |
37 | u32 rule_cnt; | |
5299a11a | 38 | u32 rule_locs[]; |
3a7da39d BH |
39 | }; |
40 | ||
41 | #endif /* CONFIG_COMPAT */ | |
c3ce7e20 | 42 | |
a1467085 DM |
43 | #include <linux/rculist.h> |
44 | ||
68f512f2 BH |
45 | /** |
46 | * enum ethtool_phys_id_state - indicator state for physical identification | |
47 | * @ETHTOOL_ID_INACTIVE: Physical ID indicator should be deactivated | |
48 | * @ETHTOOL_ID_ACTIVE: Physical ID indicator should be activated | |
49 | * @ETHTOOL_ID_ON: LED should be turned on (used iff %ETHTOOL_ID_ACTIVE | |
50 | * is not supported) | |
51 | * @ETHTOOL_ID_OFF: LED should be turned off (used iff %ETHTOOL_ID_ACTIVE | |
52 | * is not supported) | |
53 | */ | |
54 | enum ethtool_phys_id_state { | |
55 | ETHTOOL_ID_INACTIVE, | |
56 | ETHTOOL_ID_ACTIVE, | |
57 | ETHTOOL_ID_ON, | |
58 | ETHTOOL_ID_OFF | |
59 | }; | |
60 | ||
892311f6 EP |
61 | enum { |
62 | ETH_RSS_HASH_TOP_BIT, /* Configurable RSS hash function - Toeplitz */ | |
63 | ETH_RSS_HASH_XOR_BIT, /* Configurable RSS hash function - Xor */ | |
abb521e3 | 64 | ETH_RSS_HASH_CRC32_BIT, /* Configurable RSS hash function - Crc32 */ |
892311f6 EP |
65 | |
66 | /* | |
67 | * Add your fresh new hash function bits above and remember to update | |
68 | * rss_hash_func_strings[] in ethtool.c | |
69 | */ | |
70 | ETH_RSS_HASH_FUNCS_COUNT | |
71 | }; | |
72 | ||
73 | #define __ETH_RSS_HASH_BIT(bit) ((u32)1 << (bit)) | |
74 | #define __ETH_RSS_HASH(name) __ETH_RSS_HASH_BIT(ETH_RSS_HASH_##name##_BIT) | |
75 | ||
76 | #define ETH_RSS_HASH_TOP __ETH_RSS_HASH(TOP) | |
77 | #define ETH_RSS_HASH_XOR __ETH_RSS_HASH(XOR) | |
abb521e3 | 78 | #define ETH_RSS_HASH_CRC32 __ETH_RSS_HASH(CRC32) |
892311f6 EP |
79 | |
80 | #define ETH_RSS_HASH_UNKNOWN 0 | |
81 | #define ETH_RSS_HASH_NO_CHANGE 0 | |
82 | ||
1da177e4 LT |
83 | struct net_device; |
84 | ||
85 | /* Some generic methods drivers may use in their ethtool_ops */ | |
86 | u32 ethtool_op_get_link(struct net_device *dev); | |
02eacbd0 | 87 | int ethtool_op_get_ts_info(struct net_device *dev, struct ethtool_ts_info *eti); |
1da177e4 | 88 | |
ecc31c60 AC |
89 | |
90 | /** | |
91 | * struct ethtool_link_ext_state_info - link extended state and substate. | |
92 | */ | |
93 | struct ethtool_link_ext_state_info { | |
94 | enum ethtool_link_ext_state link_ext_state; | |
95 | union { | |
96 | enum ethtool_link_ext_substate_autoneg autoneg; | |
97 | enum ethtool_link_ext_substate_link_training link_training; | |
98 | enum ethtool_link_ext_substate_link_logical_mismatch link_logical_mismatch; | |
99 | enum ethtool_link_ext_substate_bad_signal_integrity bad_signal_integrity; | |
100 | enum ethtool_link_ext_substate_cable_issue cable_issue; | |
101 | u8 __link_ext_substate; | |
102 | }; | |
103 | }; | |
104 | ||
278bc429 BH |
105 | /** |
106 | * ethtool_rxfh_indir_default - get default value for RX flow hash indirection | |
107 | * @index: Index in RX flow hash indirection table | |
108 | * @n_rx_rings: Number of RX rings to use | |
109 | * | |
110 | * This function provides the default policy for RX flow hash indirection. | |
111 | */ | |
112 | static inline u32 ethtool_rxfh_indir_default(u32 index, u32 n_rx_rings) | |
113 | { | |
114 | return index % n_rx_rings; | |
115 | } | |
116 | ||
3f1ac7a7 DD |
117 | /* declare a link mode bitmap */ |
118 | #define __ETHTOOL_DECLARE_LINK_MODE_MASK(name) \ | |
119 | DECLARE_BITMAP(name, __ETHTOOL_LINK_MODE_MASK_NBITS) | |
120 | ||
121 | /* drivers must ignore base.cmd and base.link_mode_masks_nwords | |
122 | * fields, but they are allowed to overwrite them (will be ignored). | |
123 | */ | |
124 | struct ethtool_link_ksettings { | |
125 | struct ethtool_link_settings base; | |
126 | struct { | |
127 | __ETHTOOL_DECLARE_LINK_MODE_MASK(supported); | |
128 | __ETHTOOL_DECLARE_LINK_MODE_MASK(advertising); | |
129 | __ETHTOOL_DECLARE_LINK_MODE_MASK(lp_advertising); | |
130 | } link_modes; | |
012ce4dd | 131 | u32 lanes; |
3f1ac7a7 DD |
132 | }; |
133 | ||
134 | /** | |
135 | * ethtool_link_ksettings_zero_link_mode - clear link_ksettings link mode mask | |
136 | * @ptr : pointer to struct ethtool_link_ksettings | |
137 | * @name : one of supported/advertising/lp_advertising | |
138 | */ | |
139 | #define ethtool_link_ksettings_zero_link_mode(ptr, name) \ | |
140 | bitmap_zero((ptr)->link_modes.name, __ETHTOOL_LINK_MODE_MASK_NBITS) | |
141 | ||
142 | /** | |
143 | * ethtool_link_ksettings_add_link_mode - set bit in link_ksettings | |
144 | * link mode mask | |
145 | * @ptr : pointer to struct ethtool_link_ksettings | |
146 | * @name : one of supported/advertising/lp_advertising | |
147 | * @mode : one of the ETHTOOL_LINK_MODE_*_BIT | |
148 | * (not atomic, no bound checking) | |
149 | */ | |
150 | #define ethtool_link_ksettings_add_link_mode(ptr, name, mode) \ | |
151 | __set_bit(ETHTOOL_LINK_MODE_ ## mode ## _BIT, (ptr)->link_modes.name) | |
152 | ||
606c07f3 LT |
153 | /** |
154 | * ethtool_link_ksettings_del_link_mode - clear bit in link_ksettings | |
155 | * link mode mask | |
156 | * @ptr : pointer to struct ethtool_link_ksettings | |
157 | * @name : one of supported/advertising/lp_advertising | |
158 | * @mode : one of the ETHTOOL_LINK_MODE_*_BIT | |
159 | * (not atomic, no bound checking) | |
160 | */ | |
161 | #define ethtool_link_ksettings_del_link_mode(ptr, name, mode) \ | |
162 | __clear_bit(ETHTOOL_LINK_MODE_ ## mode ## _BIT, (ptr)->link_modes.name) | |
163 | ||
3f1ac7a7 DD |
164 | /** |
165 | * ethtool_link_ksettings_test_link_mode - test bit in ksettings link mode mask | |
166 | * @ptr : pointer to struct ethtool_link_ksettings | |
167 | * @name : one of supported/advertising/lp_advertising | |
168 | * @mode : one of the ETHTOOL_LINK_MODE_*_BIT | |
169 | * (not atomic, no bound checking) | |
170 | * | |
171 | * Returns true/false. | |
172 | */ | |
173 | #define ethtool_link_ksettings_test_link_mode(ptr, name, mode) \ | |
174 | test_bit(ETHTOOL_LINK_MODE_ ## mode ## _BIT, (ptr)->link_modes.name) | |
175 | ||
176 | extern int | |
177 | __ethtool_get_link_ksettings(struct net_device *dev, | |
178 | struct ethtool_link_ksettings *link_ksettings); | |
179 | ||
5a6cd6de AB |
180 | /** |
181 | * ethtool_intersect_link_masks - Given two link masks, AND them together | |
182 | * @dst: first mask and where result is stored | |
183 | * @src: second mask to intersect with | |
184 | * | |
185 | * Given two link mode masks, AND them together and save the result in dst. | |
186 | */ | |
187 | void ethtool_intersect_link_masks(struct ethtool_link_ksettings *dst, | |
188 | struct ethtool_link_ksettings *src); | |
189 | ||
6d62b4d5 PR |
190 | void ethtool_convert_legacy_u32_to_link_mode(unsigned long *dst, |
191 | u32 legacy_u32); | |
192 | ||
193 | /* return false if src had higher bits set. lower bits always updated. */ | |
194 | bool ethtool_convert_link_mode_to_legacy_u32(u32 *legacy_u32, | |
195 | const unsigned long *src); | |
196 | ||
95cddcb5 JK |
197 | #define ETHTOOL_COALESCE_RX_USECS BIT(0) |
198 | #define ETHTOOL_COALESCE_RX_MAX_FRAMES BIT(1) | |
199 | #define ETHTOOL_COALESCE_RX_USECS_IRQ BIT(2) | |
200 | #define ETHTOOL_COALESCE_RX_MAX_FRAMES_IRQ BIT(3) | |
201 | #define ETHTOOL_COALESCE_TX_USECS BIT(4) | |
202 | #define ETHTOOL_COALESCE_TX_MAX_FRAMES BIT(5) | |
203 | #define ETHTOOL_COALESCE_TX_USECS_IRQ BIT(6) | |
204 | #define ETHTOOL_COALESCE_TX_MAX_FRAMES_IRQ BIT(7) | |
205 | #define ETHTOOL_COALESCE_STATS_BLOCK_USECS BIT(8) | |
206 | #define ETHTOOL_COALESCE_USE_ADAPTIVE_RX BIT(9) | |
207 | #define ETHTOOL_COALESCE_USE_ADAPTIVE_TX BIT(10) | |
208 | #define ETHTOOL_COALESCE_PKT_RATE_LOW BIT(11) | |
209 | #define ETHTOOL_COALESCE_RX_USECS_LOW BIT(12) | |
210 | #define ETHTOOL_COALESCE_RX_MAX_FRAMES_LOW BIT(13) | |
211 | #define ETHTOOL_COALESCE_TX_USECS_LOW BIT(14) | |
212 | #define ETHTOOL_COALESCE_TX_MAX_FRAMES_LOW BIT(15) | |
213 | #define ETHTOOL_COALESCE_PKT_RATE_HIGH BIT(16) | |
214 | #define ETHTOOL_COALESCE_RX_USECS_HIGH BIT(17) | |
215 | #define ETHTOOL_COALESCE_RX_MAX_FRAMES_HIGH BIT(18) | |
216 | #define ETHTOOL_COALESCE_TX_USECS_HIGH BIT(19) | |
217 | #define ETHTOOL_COALESCE_TX_MAX_FRAMES_HIGH BIT(20) | |
218 | #define ETHTOOL_COALESCE_RATE_SAMPLE_INTERVAL BIT(21) | |
4ae21993 | 219 | #define ETHTOOL_COALESCE_ALL_PARAMS GENMASK(21, 0) |
95cddcb5 JK |
220 | |
221 | #define ETHTOOL_COALESCE_USECS \ | |
222 | (ETHTOOL_COALESCE_RX_USECS | ETHTOOL_COALESCE_TX_USECS) | |
223 | #define ETHTOOL_COALESCE_MAX_FRAMES \ | |
224 | (ETHTOOL_COALESCE_RX_MAX_FRAMES | ETHTOOL_COALESCE_TX_MAX_FRAMES) | |
225 | #define ETHTOOL_COALESCE_USECS_IRQ \ | |
226 | (ETHTOOL_COALESCE_RX_USECS_IRQ | ETHTOOL_COALESCE_TX_USECS_IRQ) | |
227 | #define ETHTOOL_COALESCE_MAX_FRAMES_IRQ \ | |
228 | (ETHTOOL_COALESCE_RX_MAX_FRAMES_IRQ | \ | |
229 | ETHTOOL_COALESCE_TX_MAX_FRAMES_IRQ) | |
230 | #define ETHTOOL_COALESCE_USE_ADAPTIVE \ | |
231 | (ETHTOOL_COALESCE_USE_ADAPTIVE_RX | ETHTOOL_COALESCE_USE_ADAPTIVE_TX) | |
8213f6c9 JK |
232 | #define ETHTOOL_COALESCE_USECS_LOW_HIGH \ |
233 | (ETHTOOL_COALESCE_RX_USECS_LOW | ETHTOOL_COALESCE_TX_USECS_LOW | \ | |
234 | ETHTOOL_COALESCE_RX_USECS_HIGH | ETHTOOL_COALESCE_TX_USECS_HIGH) | |
4f9546d2 JK |
235 | #define ETHTOOL_COALESCE_MAX_FRAMES_LOW_HIGH \ |
236 | (ETHTOOL_COALESCE_RX_MAX_FRAMES_LOW | \ | |
237 | ETHTOOL_COALESCE_TX_MAX_FRAMES_LOW | \ | |
238 | ETHTOOL_COALESCE_RX_MAX_FRAMES_HIGH | \ | |
239 | ETHTOOL_COALESCE_TX_MAX_FRAMES_HIGH) | |
812df69b JK |
240 | #define ETHTOOL_COALESCE_PKT_RATE_RX_USECS \ |
241 | (ETHTOOL_COALESCE_USE_ADAPTIVE_RX | \ | |
242 | ETHTOOL_COALESCE_RX_USECS_LOW | ETHTOOL_COALESCE_RX_USECS_HIGH | \ | |
243 | ETHTOOL_COALESCE_PKT_RATE_LOW | ETHTOOL_COALESCE_PKT_RATE_HIGH | \ | |
244 | ETHTOOL_COALESCE_RATE_SAMPLE_INTERVAL) | |
95cddcb5 | 245 | |
9a27a330 JK |
246 | #define ETHTOOL_STAT_NOT_SET (~0ULL) |
247 | ||
248 | /** | |
249 | * struct ethtool_pause_stats - statistics for IEEE 802.3x pause frames | |
250 | * @tx_pause_frames: transmitted pause frame count. Reported to user space | |
251 | * as %ETHTOOL_A_PAUSE_STAT_TX_FRAMES. | |
252 | * | |
253 | * Equivalent to `30.3.4.2 aPAUSEMACCtrlFramesTransmitted` | |
254 | * from the standard. | |
255 | * | |
256 | * @rx_pause_frames: received pause frame count. Reported to user space | |
257 | * as %ETHTOOL_A_PAUSE_STAT_RX_FRAMES. Equivalent to: | |
258 | * | |
259 | * Equivalent to `30.3.4.3 aPAUSEMACCtrlFramesReceived` | |
260 | * from the standard. | |
261 | */ | |
262 | struct ethtool_pause_stats { | |
263 | u64 tx_pause_frames; | |
264 | u64 rx_pause_frames; | |
265 | }; | |
266 | ||
1da177e4 | 267 | /** |
8717d07b | 268 | * struct ethtool_ops - optional netdev operations |
012ce4dd DR |
269 | * @cap_link_lanes_supported: indicates if the driver supports lanes |
270 | * parameter. | |
95cddcb5 | 271 | * @supported_coalesce_params: supported types of interrupt coalescing. |
8717d07b BH |
272 | * @get_drvinfo: Report driver/device information. Should only set the |
273 | * @driver, @version, @fw_version and @bus_info fields. If not | |
274 | * implemented, the @driver and @bus_info fields will be filled in | |
275 | * according to the netdev's parent device. | |
276 | * @get_regs_len: Get buffer length required for @get_regs | |
e20b5b61 BH |
277 | * @get_regs: Get device registers |
278 | * @get_wol: Report whether Wake-on-Lan is enabled | |
8717d07b BH |
279 | * @set_wol: Turn Wake-on-Lan on or off. Returns a negative error code |
280 | * or zero. | |
281 | * @get_msglevel: Report driver message level. This should be the value | |
282 | * of the @msg_enable field used by netif logging functions. | |
e20b5b61 | 283 | * @set_msglevel: Set driver message level |
8717d07b BH |
284 | * @nway_reset: Restart autonegotiation. Returns a negative error code |
285 | * or zero. | |
286 | * @get_link: Report whether physical link is up. Will only be called if | |
287 | * the netdev is up. Should usually be set to ethtool_op_get_link(), | |
288 | * which uses netif_carrier_ok(). | |
ecc31c60 AC |
289 | * @get_link_ext_state: Report link extended state. Should set link_ext_state and |
290 | * link_ext_substate (link_ext_substate of 0 means link_ext_substate is unknown, | |
291 | * do not attach ext_substate attribute to netlink message). If link_ext_state | |
292 | * and link_ext_substate are unknown, return -ENODATA. If not implemented, | |
293 | * link_ext_state and link_ext_substate will not be sent to userspace. | |
e20b5b61 | 294 | * @get_eeprom: Read data from the device EEPROM. |
1da177e4 LT |
295 | * Should fill in the magic field. Don't need to check len for zero |
296 | * or wraparound. Fill in the data argument with the eeprom values | |
297 | * from offset to offset + len. Update len to the amount read. | |
298 | * Returns an error or zero. | |
e20b5b61 | 299 | * @set_eeprom: Write data to the device EEPROM. |
1da177e4 LT |
300 | * Should validate the magic field. Don't need to check len for zero |
301 | * or wraparound. Update len to the amount written. Returns an error | |
302 | * or zero. | |
8717d07b BH |
303 | * @get_coalesce: Get interrupt coalescing parameters. Returns a negative |
304 | * error code or zero. | |
95cddcb5 JK |
305 | * @set_coalesce: Set interrupt coalescing parameters. Supported coalescing |
306 | * types should be set in @supported_coalesce_params. | |
307 | * Returns a negative error code or zero. | |
e20b5b61 | 308 | * @get_ringparam: Report ring sizes |
8717d07b | 309 | * @set_ringparam: Set ring sizes. Returns a negative error code or zero. |
9a27a330 JK |
310 | * @get_pause_stats: Report pause frame statistics. Drivers must not zero |
311 | * statistics which they don't report. The stats structure is initialized | |
312 | * to ETHTOOL_STAT_NOT_SET indicating driver does not report statistics. | |
e20b5b61 | 313 | * @get_pauseparam: Report pause parameters |
8717d07b BH |
314 | * @set_pauseparam: Set pause parameters. Returns a negative error code |
315 | * or zero. | |
e20b5b61 BH |
316 | * @self_test: Run specified self-tests |
317 | * @get_strings: Return a set of strings that describe the requested objects | |
68f512f2 BH |
318 | * @set_phys_id: Identify the physical devices, e.g. by flashing an LED |
319 | * attached to it. The implementation may update the indicator | |
320 | * asynchronously or synchronously, but in either case it must return | |
321 | * quickly. It is initially called with the argument %ETHTOOL_ID_ACTIVE, | |
fce55922 AB |
322 | * and must either activate asynchronous updates and return zero, return |
323 | * a negative error or return a positive frequency for synchronous | |
324 | * indication (e.g. 1 for one on/off cycle per second). If it returns | |
325 | * a frequency then it will be called again at intervals with the | |
68f512f2 BH |
326 | * argument %ETHTOOL_ID_ON or %ETHTOOL_ID_OFF and should set the state of |
327 | * the indicator accordingly. Finally, it is called with the argument | |
328 | * %ETHTOOL_ID_INACTIVE and must deactivate the indicator. Returns a | |
329 | * negative error code or zero. | |
8717d07b BH |
330 | * @get_ethtool_stats: Return extended statistics about the device. |
331 | * This is only useful if the device maintains statistics not | |
332 | * included in &struct rtnl_link_stats64. | |
333 | * @begin: Function to be called before any other operation. Returns a | |
334 | * negative error code or zero. | |
335 | * @complete: Function to be called after any other operation except | |
336 | * @begin. Will be called even if the other operation failed. | |
8717d07b BH |
337 | * @get_priv_flags: Report driver-specific feature flags. |
338 | * @set_priv_flags: Set driver-specific feature flags. Returns a negative | |
339 | * error code or zero. | |
340 | * @get_sset_count: Get number of strings that @get_strings will write. | |
341 | * @get_rxnfc: Get RX flow classification rules. Returns a negative | |
342 | * error code or zero. | |
343 | * @set_rxnfc: Set RX flow classification rules. Returns a negative | |
344 | * error code or zero. | |
345 | * @flash_device: Write a firmware image to device's flash memory. | |
346 | * Returns a negative error code or zero. | |
347 | * @reset: Reset (part of) the device, as specified by a bitmask of | |
348 | * flags from &enum ethtool_reset_flags. Returns a negative | |
349 | * error code or zero. | |
3de0b592 VD |
350 | * @get_rxfh_key_size: Get the size of the RX flow hash key. |
351 | * Returns zero if not supported for this specific device. | |
7850f63f BH |
352 | * @get_rxfh_indir_size: Get the size of the RX flow hash indirection table. |
353 | * Returns zero if not supported for this specific device. | |
892311f6 EP |
354 | * @get_rxfh: Get the contents of the RX flow hash indirection table, hash key |
355 | * and/or hash function. | |
8717d07b | 356 | * Returns a negative error code or zero. |
892311f6 EP |
357 | * @set_rxfh: Set the contents of the RX flow hash indirection table, hash |
358 | * key, and/or hash function. Arguments which are set to %NULL or zero | |
359 | * will remain unchanged. | |
360 | * Returns a negative error code or zero. An error code must be returned | |
361 | * if at least one unsupported change was requested. | |
f4bcf14e MC |
362 | * @get_rxfh_context: Get the contents of the RX flow hash indirection table, |
363 | * hash key, and/or hash function assiciated to the given rss context. | |
364 | * Returns a negative error code or zero. | |
365 | * @set_rxfh_context: Create, remove and configure RSS contexts. Allows setting | |
366 | * the contents of the RX flow hash indirection table, hash key, and/or | |
367 | * hash function associated to the given context. Arguments which are set | |
368 | * to %NULL or zero will remain unchanged. | |
369 | * Returns a negative error code or zero. An error code must be returned | |
370 | * if at least one unsupported change was requested. | |
8b5933c3 | 371 | * @get_channels: Get number of channels. |
372 | * @set_channels: Set number of channels. Returns a negative error code or | |
373 | * zero. | |
29dd54b7 AC |
374 | * @get_dump_flag: Get dump flag indicating current dump length, version, |
375 | * and flag of the device. | |
376 | * @get_dump_data: Get dump data. | |
377 | * @set_dump: Set dump specific flags to the device. | |
c8f3a8c3 RC |
378 | * @get_ts_info: Get the time stamping and PTP hardware clock capabilities. |
379 | * Drivers supporting transmit time stamps in software should set this to | |
380 | * ethtool_op_get_ts_info(). | |
41c3cb6d SH |
381 | * @get_module_info: Get the size and type of the eeprom contained within |
382 | * a plug-in module. | |
383 | * @get_module_eeprom: Get the eeprom information from the plug-in module | |
80f12ecc YM |
384 | * @get_eee: Get Energy-Efficient (EEE) supported and status. |
385 | * @set_eee: Set EEE status (enable/disable) as well as LPI timers. | |
421797b1 KL |
386 | * @get_per_queue_coalesce: Get interrupt coalescing parameters per queue. |
387 | * It must check that the given queue number is valid. If neither a RX nor | |
388 | * a TX queue has this number, return -EINVAL. If only a RX queue or a TX | |
389 | * queue has this number, set the inapplicable fields to ~0 and return 0. | |
390 | * Returns a negative error code or zero. | |
f38d138a KL |
391 | * @set_per_queue_coalesce: Set interrupt coalescing parameters per queue. |
392 | * It must check that the given queue number is valid. If neither a RX nor | |
393 | * a TX queue has this number, return -EINVAL. If only a RX queue or a TX | |
95cddcb5 JK |
394 | * queue has this number, ignore the inapplicable fields. Supported |
395 | * coalescing types should be set in @supported_coalesce_params. | |
f38d138a | 396 | * Returns a negative error code or zero. |
9b300495 MK |
397 | * @get_link_ksettings: Get various device settings including Ethernet link |
398 | * settings. The %cmd and %link_mode_masks_nwords fields should be | |
399 | * ignored (use %__ETHTOOL_LINK_MODE_MASK_NBITS instead of the latter), | |
400 | * any change to them will be overwritten by kernel. Returns a negative | |
401 | * error code or zero. | |
402 | * @set_link_ksettings: Set various device settings including Ethernet link | |
403 | * settings. The %cmd and %link_mode_masks_nwords fields should be | |
404 | * ignored (use %__ETHTOOL_LINK_MODE_MASK_NBITS instead of the latter), | |
405 | * any change to them will be overwritten by kernel. Returns a negative | |
406 | * error code or zero. | |
d805c520 FF |
407 | * @get_fecparam: Get the network device Forward Error Correction parameters. |
408 | * @set_fecparam: Set the network device Forward Error Correction parameters. | |
99943382 FF |
409 | * @get_ethtool_phy_stats: Return extended statistics about the PHY device. |
410 | * This is only useful if the device maintains PHY statistics and | |
411 | * cannot use the standard PHY library helpers. | |
8717d07b BH |
412 | * |
413 | * All operations are optional (i.e. the function pointer may be set | |
414 | * to %NULL) and callers must take this into account. Callers must | |
b4f79e5c | 415 | * hold the RTNL lock. |
8717d07b BH |
416 | * |
417 | * See the structures used by these operations for further documentation. | |
6e201c85 BH |
418 | * Note that for all operations using a structure ending with a zero- |
419 | * length array, the array is allocated separately in the kernel and | |
420 | * is passed to the driver as an additional parameter. | |
8717d07b BH |
421 | * |
422 | * See &struct net_device and &struct net_device_ops for documentation | |
423 | * of the generic netdev features interface. | |
1da177e4 LT |
424 | */ |
425 | struct ethtool_ops { | |
012ce4dd | 426 | u32 cap_link_lanes_supported:1; |
95cddcb5 | 427 | u32 supported_coalesce_params; |
1da177e4 LT |
428 | void (*get_drvinfo)(struct net_device *, struct ethtool_drvinfo *); |
429 | int (*get_regs_len)(struct net_device *); | |
430 | void (*get_regs)(struct net_device *, struct ethtool_regs *, void *); | |
431 | void (*get_wol)(struct net_device *, struct ethtool_wolinfo *); | |
432 | int (*set_wol)(struct net_device *, struct ethtool_wolinfo *); | |
433 | u32 (*get_msglevel)(struct net_device *); | |
434 | void (*set_msglevel)(struct net_device *, u32); | |
435 | int (*nway_reset)(struct net_device *); | |
436 | u32 (*get_link)(struct net_device *); | |
ecc31c60 AC |
437 | int (*get_link_ext_state)(struct net_device *, |
438 | struct ethtool_link_ext_state_info *); | |
1da177e4 | 439 | int (*get_eeprom_len)(struct net_device *); |
97f8aefb | 440 | int (*get_eeprom)(struct net_device *, |
441 | struct ethtool_eeprom *, u8 *); | |
442 | int (*set_eeprom)(struct net_device *, | |
443 | struct ethtool_eeprom *, u8 *); | |
1da177e4 LT |
444 | int (*get_coalesce)(struct net_device *, struct ethtool_coalesce *); |
445 | int (*set_coalesce)(struct net_device *, struct ethtool_coalesce *); | |
97f8aefb | 446 | void (*get_ringparam)(struct net_device *, |
447 | struct ethtool_ringparam *); | |
448 | int (*set_ringparam)(struct net_device *, | |
449 | struct ethtool_ringparam *); | |
9a27a330 JK |
450 | void (*get_pause_stats)(struct net_device *dev, |
451 | struct ethtool_pause_stats *pause_stats); | |
97f8aefb | 452 | void (*get_pauseparam)(struct net_device *, |
453 | struct ethtool_pauseparam*); | |
454 | int (*set_pauseparam)(struct net_device *, | |
455 | struct ethtool_pauseparam*); | |
1da177e4 LT |
456 | void (*self_test)(struct net_device *, struct ethtool_test *, u64 *); |
457 | void (*get_strings)(struct net_device *, u32 stringset, u8 *); | |
68f512f2 | 458 | int (*set_phys_id)(struct net_device *, enum ethtool_phys_id_state); |
97f8aefb | 459 | void (*get_ethtool_stats)(struct net_device *, |
460 | struct ethtool_stats *, u64 *); | |
1da177e4 LT |
461 | int (*begin)(struct net_device *); |
462 | void (*complete)(struct net_device *); | |
97f8aefb | 463 | u32 (*get_priv_flags)(struct net_device *); |
464 | int (*set_priv_flags)(struct net_device *, u32); | |
ff03d49f | 465 | int (*get_sset_count)(struct net_device *, int); |
97f8aefb | 466 | int (*get_rxnfc)(struct net_device *, |
815c7db5 | 467 | struct ethtool_rxnfc *, u32 *rule_locs); |
59089d8d | 468 | int (*set_rxnfc)(struct net_device *, struct ethtool_rxnfc *); |
97f8aefb | 469 | int (*flash_device)(struct net_device *, struct ethtool_flash *); |
d73d3a8c | 470 | int (*reset)(struct net_device *, u32 *); |
3de0b592 | 471 | u32 (*get_rxfh_key_size)(struct net_device *); |
7850f63f | 472 | u32 (*get_rxfh_indir_size)(struct net_device *); |
892311f6 EP |
473 | int (*get_rxfh)(struct net_device *, u32 *indir, u8 *key, |
474 | u8 *hfunc); | |
33cb0fa7 | 475 | int (*set_rxfh)(struct net_device *, const u32 *indir, |
892311f6 | 476 | const u8 *key, const u8 hfunc); |
84a1d9c4 EC |
477 | int (*get_rxfh_context)(struct net_device *, u32 *indir, u8 *key, |
478 | u8 *hfunc, u32 rss_context); | |
479 | int (*set_rxfh_context)(struct net_device *, const u32 *indir, | |
480 | const u8 *key, const u8 hfunc, | |
481 | u32 *rss_context, bool delete); | |
8b5933c3 | 482 | void (*get_channels)(struct net_device *, struct ethtool_channels *); |
483 | int (*set_channels)(struct net_device *, struct ethtool_channels *); | |
29dd54b7 AC |
484 | int (*get_dump_flag)(struct net_device *, struct ethtool_dump *); |
485 | int (*get_dump_data)(struct net_device *, | |
486 | struct ethtool_dump *, void *); | |
487 | int (*set_dump)(struct net_device *, struct ethtool_dump *); | |
c8f3a8c3 | 488 | int (*get_ts_info)(struct net_device *, struct ethtool_ts_info *); |
41c3cb6d SH |
489 | int (*get_module_info)(struct net_device *, |
490 | struct ethtool_modinfo *); | |
491 | int (*get_module_eeprom)(struct net_device *, | |
492 | struct ethtool_eeprom *, u8 *); | |
80f12ecc YM |
493 | int (*get_eee)(struct net_device *, struct ethtool_eee *); |
494 | int (*set_eee)(struct net_device *, struct ethtool_eee *); | |
f0db9b07 GV |
495 | int (*get_tunable)(struct net_device *, |
496 | const struct ethtool_tunable *, void *); | |
497 | int (*set_tunable)(struct net_device *, | |
498 | const struct ethtool_tunable *, const void *); | |
421797b1 KL |
499 | int (*get_per_queue_coalesce)(struct net_device *, u32, |
500 | struct ethtool_coalesce *); | |
f38d138a KL |
501 | int (*set_per_queue_coalesce)(struct net_device *, u32, |
502 | struct ethtool_coalesce *); | |
3f1ac7a7 DD |
503 | int (*get_link_ksettings)(struct net_device *, |
504 | struct ethtool_link_ksettings *); | |
505 | int (*set_link_ksettings)(struct net_device *, | |
506 | const struct ethtool_link_ksettings *); | |
1a5f3da2 VSR |
507 | int (*get_fecparam)(struct net_device *, |
508 | struct ethtool_fecparam *); | |
509 | int (*set_fecparam)(struct net_device *, | |
510 | struct ethtool_fecparam *); | |
99943382 FF |
511 | void (*get_ethtool_phy_stats)(struct net_device *, |
512 | struct ethtool_stats *, u64 *); | |
c6db31ff IR |
513 | int (*get_phy_tunable)(struct net_device *, |
514 | const struct ethtool_tunable *, void *); | |
515 | int (*set_phy_tunable)(struct net_device *, | |
516 | const struct ethtool_tunable *, const void *); | |
1da177e4 | 517 | }; |
eca4205f | 518 | |
9000edb7 JK |
519 | int ethtool_check_ops(const struct ethtool_ops *ops); |
520 | ||
eca4205f PNA |
521 | struct ethtool_rx_flow_rule { |
522 | struct flow_rule *rule; | |
5299a11a | 523 | unsigned long priv[]; |
eca4205f PNA |
524 | }; |
525 | ||
526 | struct ethtool_rx_flow_spec_input { | |
527 | const struct ethtool_rx_flow_spec *fs; | |
528 | u32 rss_ctx; | |
529 | }; | |
530 | ||
531 | struct ethtool_rx_flow_rule * | |
532 | ethtool_rx_flow_rule_create(const struct ethtool_rx_flow_spec_input *input); | |
533 | void ethtool_rx_flow_rule_destroy(struct ethtool_rx_flow_rule *rule); | |
534 | ||
70ae1e12 CF |
535 | bool ethtool_virtdev_validate_cmd(const struct ethtool_link_ksettings *cmd); |
536 | int ethtool_virtdev_set_link_ksettings(struct net_device *dev, | |
537 | const struct ethtool_link_ksettings *cmd, | |
538 | u32 *dev_speed, u8 *dev_duplex); | |
539 | ||
4895d780 FF |
540 | struct netlink_ext_ack; |
541 | struct phy_device; | |
542 | struct phy_tdr_config; | |
543 | ||
544 | /** | |
545 | * struct ethtool_phy_ops - Optional PHY device options | |
bd36ed1c FF |
546 | * @get_sset_count: Get number of strings that @get_strings will write. |
547 | * @get_strings: Return a set of strings that describe the requested objects | |
548 | * @get_stats: Return extended statistics about the PHY device. | |
4895d780 FF |
549 | * @start_cable_test - Start a cable test |
550 | * @start_cable_test_tdr - Start a Time Domain Reflectometry cable test | |
551 | * | |
552 | * All operations are optional (i.e. the function pointer may be set to %NULL) | |
553 | * and callers must take this into account. Callers must hold the RTNL lock. | |
554 | */ | |
555 | struct ethtool_phy_ops { | |
bd36ed1c FF |
556 | int (*get_sset_count)(struct phy_device *dev); |
557 | int (*get_strings)(struct phy_device *dev, u8 *data); | |
558 | int (*get_stats)(struct phy_device *dev, | |
559 | struct ethtool_stats *stats, u64 *data); | |
4895d780 FF |
560 | int (*start_cable_test)(struct phy_device *phydev, |
561 | struct netlink_ext_ack *extack); | |
562 | int (*start_cable_test_tdr)(struct phy_device *phydev, | |
563 | struct netlink_ext_ack *extack, | |
564 | const struct phy_tdr_config *config); | |
565 | }; | |
566 | ||
567 | /** | |
568 | * ethtool_set_ethtool_phy_ops - Set the ethtool_phy_ops singleton | |
569 | * @ops: Ethtool PHY operations to set | |
570 | */ | |
571 | void ethtool_set_ethtool_phy_ops(const struct ethtool_phy_ops *ops); | |
70ae1e12 | 572 | |
1da177e4 | 573 | #endif /* _LINUX_ETHTOOL_H */ |