2 * ethtool.h: Defines for Linux ethtool.
4 * Copyright (C) 1998 David S. Miller (davem@redhat.com)
5 * Copyright 2001 Jeff Garzik <jgarzik@pobox.com>
6 * Portions Copyright 2001 Sun Microsystems (thockin@sun.com)
7 * Portions Copyright 2002 Intel (eli.kupermann@intel.com,
8 * christopher.leech@intel.com,
9 * scott.feldman@intel.com)
10 * Portions Copyright (C) Sun Microsystems 2008
12 #ifndef _LINUX_ETHTOOL_H
13 #define _LINUX_ETHTOOL_H
15 #include <linux/bitmap.h>
16 #include <linux/compat.h>
17 #include <uapi/linux/ethtool.h>
21 struct compat_ethtool_rx_flow_spec
{
23 union ethtool_flow_union h_u
;
24 struct ethtool_flow_ext h_ext
;
25 union ethtool_flow_union m_u
;
26 struct ethtool_flow_ext m_ext
;
27 compat_u64 ring_cookie
;
31 struct compat_ethtool_rxnfc
{
35 struct compat_ethtool_rx_flow_spec fs
;
40 #endif /* CONFIG_COMPAT */
42 #include <linux/rculist.h>
45 * enum ethtool_phys_id_state - indicator state for physical identification
46 * @ETHTOOL_ID_INACTIVE: Physical ID indicator should be deactivated
47 * @ETHTOOL_ID_ACTIVE: Physical ID indicator should be activated
48 * @ETHTOOL_ID_ON: LED should be turned on (used iff %ETHTOOL_ID_ACTIVE
50 * @ETHTOOL_ID_OFF: LED should be turned off (used iff %ETHTOOL_ID_ACTIVE
53 enum ethtool_phys_id_state
{
61 ETH_RSS_HASH_TOP_BIT
, /* Configurable RSS hash function - Toeplitz */
62 ETH_RSS_HASH_XOR_BIT
, /* Configurable RSS hash function - Xor */
65 * Add your fresh new hash function bits above and remember to update
66 * rss_hash_func_strings[] in ethtool.c
68 ETH_RSS_HASH_FUNCS_COUNT
71 #define __ETH_RSS_HASH_BIT(bit) ((u32)1 << (bit))
72 #define __ETH_RSS_HASH(name) __ETH_RSS_HASH_BIT(ETH_RSS_HASH_##name##_BIT)
74 #define ETH_RSS_HASH_TOP __ETH_RSS_HASH(TOP)
75 #define ETH_RSS_HASH_XOR __ETH_RSS_HASH(XOR)
77 #define ETH_RSS_HASH_UNKNOWN 0
78 #define ETH_RSS_HASH_NO_CHANGE 0
82 /* Some generic methods drivers may use in their ethtool_ops */
83 u32
ethtool_op_get_link(struct net_device
*dev
);
84 int ethtool_op_get_ts_info(struct net_device
*dev
, struct ethtool_ts_info
*eti
);
87 * ethtool_rxfh_indir_default - get default value for RX flow hash indirection
88 * @index: Index in RX flow hash indirection table
89 * @n_rx_rings: Number of RX rings to use
91 * This function provides the default policy for RX flow hash indirection.
93 static inline u32
ethtool_rxfh_indir_default(u32 index
, u32 n_rx_rings
)
95 return index
% n_rx_rings
;
98 /* number of link mode bits/ulongs handled internally by kernel */
99 #define __ETHTOOL_LINK_MODE_MASK_NBITS \
100 (__ETHTOOL_LINK_MODE_LAST + 1)
102 /* declare a link mode bitmap */
103 #define __ETHTOOL_DECLARE_LINK_MODE_MASK(name) \
104 DECLARE_BITMAP(name, __ETHTOOL_LINK_MODE_MASK_NBITS)
106 /* drivers must ignore base.cmd and base.link_mode_masks_nwords
107 * fields, but they are allowed to overwrite them (will be ignored).
109 struct ethtool_link_ksettings
{
110 struct ethtool_link_settings base
;
112 __ETHTOOL_DECLARE_LINK_MODE_MASK(supported
);
113 __ETHTOOL_DECLARE_LINK_MODE_MASK(advertising
);
114 __ETHTOOL_DECLARE_LINK_MODE_MASK(lp_advertising
);
119 * ethtool_link_ksettings_zero_link_mode - clear link_ksettings link mode mask
120 * @ptr : pointer to struct ethtool_link_ksettings
121 * @name : one of supported/advertising/lp_advertising
123 #define ethtool_link_ksettings_zero_link_mode(ptr, name) \
124 bitmap_zero((ptr)->link_modes.name, __ETHTOOL_LINK_MODE_MASK_NBITS)
127 * ethtool_link_ksettings_add_link_mode - set bit in link_ksettings
129 * @ptr : pointer to struct ethtool_link_ksettings
130 * @name : one of supported/advertising/lp_advertising
131 * @mode : one of the ETHTOOL_LINK_MODE_*_BIT
132 * (not atomic, no bound checking)
134 #define ethtool_link_ksettings_add_link_mode(ptr, name, mode) \
135 __set_bit(ETHTOOL_LINK_MODE_ ## mode ## _BIT, (ptr)->link_modes.name)
138 * ethtool_link_ksettings_test_link_mode - test bit in ksettings link mode mask
139 * @ptr : pointer to struct ethtool_link_ksettings
140 * @name : one of supported/advertising/lp_advertising
141 * @mode : one of the ETHTOOL_LINK_MODE_*_BIT
142 * (not atomic, no bound checking)
144 * Returns true/false.
146 #define ethtool_link_ksettings_test_link_mode(ptr, name, mode) \
147 test_bit(ETHTOOL_LINK_MODE_ ## mode ## _BIT, (ptr)->link_modes.name)
150 __ethtool_get_link_ksettings(struct net_device
*dev
,
151 struct ethtool_link_ksettings
*link_ksettings
);
153 /* DEPRECATED, use __ethtool_get_link_ksettings */
154 extern int __ethtool_get_settings(struct net_device
*dev
,
155 struct ethtool_cmd
*cmd
);
158 * struct ethtool_ops - optional netdev operations
159 * @get_settings: DEPRECATED, use %get_link_ksettings/%set_link_ksettings
160 * API. Get various device settings including Ethernet link
161 * settings. The @cmd parameter is expected to have been cleared
162 * before get_settings is called. Returns a negative error code
164 * @set_settings: DEPRECATED, use %get_link_ksettings/%set_link_ksettings
165 * API. Set various device settings including Ethernet link
166 * settings. Returns a negative error code or zero.
167 * @get_drvinfo: Report driver/device information. Should only set the
168 * @driver, @version, @fw_version and @bus_info fields. If not
169 * implemented, the @driver and @bus_info fields will be filled in
170 * according to the netdev's parent device.
171 * @get_regs_len: Get buffer length required for @get_regs
172 * @get_regs: Get device registers
173 * @get_wol: Report whether Wake-on-Lan is enabled
174 * @set_wol: Turn Wake-on-Lan on or off. Returns a negative error code
176 * @get_msglevel: Report driver message level. This should be the value
177 * of the @msg_enable field used by netif logging functions.
178 * @set_msglevel: Set driver message level
179 * @nway_reset: Restart autonegotiation. Returns a negative error code
181 * @get_link: Report whether physical link is up. Will only be called if
182 * the netdev is up. Should usually be set to ethtool_op_get_link(),
183 * which uses netif_carrier_ok().
184 * @get_eeprom: Read data from the device EEPROM.
185 * Should fill in the magic field. Don't need to check len for zero
186 * or wraparound. Fill in the data argument with the eeprom values
187 * from offset to offset + len. Update len to the amount read.
188 * Returns an error or zero.
189 * @set_eeprom: Write data to the device EEPROM.
190 * Should validate the magic field. Don't need to check len for zero
191 * or wraparound. Update len to the amount written. Returns an error
193 * @get_coalesce: Get interrupt coalescing parameters. Returns a negative
194 * error code or zero.
195 * @set_coalesce: Set interrupt coalescing parameters. Returns a negative
196 * error code or zero.
197 * @get_ringparam: Report ring sizes
198 * @set_ringparam: Set ring sizes. Returns a negative error code or zero.
199 * @get_pauseparam: Report pause parameters
200 * @set_pauseparam: Set pause parameters. Returns a negative error code
202 * @self_test: Run specified self-tests
203 * @get_strings: Return a set of strings that describe the requested objects
204 * @set_phys_id: Identify the physical devices, e.g. by flashing an LED
205 * attached to it. The implementation may update the indicator
206 * asynchronously or synchronously, but in either case it must return
207 * quickly. It is initially called with the argument %ETHTOOL_ID_ACTIVE,
208 * and must either activate asynchronous updates and return zero, return
209 * a negative error or return a positive frequency for synchronous
210 * indication (e.g. 1 for one on/off cycle per second). If it returns
211 * a frequency then it will be called again at intervals with the
212 * argument %ETHTOOL_ID_ON or %ETHTOOL_ID_OFF and should set the state of
213 * the indicator accordingly. Finally, it is called with the argument
214 * %ETHTOOL_ID_INACTIVE and must deactivate the indicator. Returns a
215 * negative error code or zero.
216 * @get_ethtool_stats: Return extended statistics about the device.
217 * This is only useful if the device maintains statistics not
218 * included in &struct rtnl_link_stats64.
219 * @begin: Function to be called before any other operation. Returns a
220 * negative error code or zero.
221 * @complete: Function to be called after any other operation except
222 * @begin. Will be called even if the other operation failed.
223 * @get_priv_flags: Report driver-specific feature flags.
224 * @set_priv_flags: Set driver-specific feature flags. Returns a negative
225 * error code or zero.
226 * @get_sset_count: Get number of strings that @get_strings will write.
227 * @get_rxnfc: Get RX flow classification rules. Returns a negative
228 * error code or zero.
229 * @set_rxnfc: Set RX flow classification rules. Returns a negative
230 * error code or zero.
231 * @flash_device: Write a firmware image to device's flash memory.
232 * Returns a negative error code or zero.
233 * @reset: Reset (part of) the device, as specified by a bitmask of
234 * flags from &enum ethtool_reset_flags. Returns a negative
235 * error code or zero.
236 * @get_rxfh_key_size: Get the size of the RX flow hash key.
237 * Returns zero if not supported for this specific device.
238 * @get_rxfh_indir_size: Get the size of the RX flow hash indirection table.
239 * Returns zero if not supported for this specific device.
240 * @get_rxfh: Get the contents of the RX flow hash indirection table, hash key
241 * and/or hash function.
242 * Returns a negative error code or zero.
243 * @set_rxfh: Set the contents of the RX flow hash indirection table, hash
244 * key, and/or hash function. Arguments which are set to %NULL or zero
245 * will remain unchanged.
246 * Returns a negative error code or zero. An error code must be returned
247 * if at least one unsupported change was requested.
248 * @get_channels: Get number of channels.
249 * @set_channels: Set number of channels. Returns a negative error code or
251 * @get_dump_flag: Get dump flag indicating current dump length, version,
252 * and flag of the device.
253 * @get_dump_data: Get dump data.
254 * @set_dump: Set dump specific flags to the device.
255 * @get_ts_info: Get the time stamping and PTP hardware clock capabilities.
256 * Drivers supporting transmit time stamps in software should set this to
257 * ethtool_op_get_ts_info().
258 * @get_module_info: Get the size and type of the eeprom contained within
260 * @get_module_eeprom: Get the eeprom information from the plug-in module
261 * @get_eee: Get Energy-Efficient (EEE) supported and status.
262 * @set_eee: Set EEE status (enable/disable) as well as LPI timers.
263 * @get_per_queue_coalesce: Get interrupt coalescing parameters per queue.
264 * It must check that the given queue number is valid. If neither a RX nor
265 * a TX queue has this number, return -EINVAL. If only a RX queue or a TX
266 * queue has this number, set the inapplicable fields to ~0 and return 0.
267 * Returns a negative error code or zero.
268 * @set_per_queue_coalesce: Set interrupt coalescing parameters per queue.
269 * It must check that the given queue number is valid. If neither a RX nor
270 * a TX queue has this number, return -EINVAL. If only a RX queue or a TX
271 * queue has this number, ignore the inapplicable fields.
272 * Returns a negative error code or zero.
273 * @get_link_ksettings: When defined, takes precedence over the
274 * %get_settings method. Get various device settings
275 * including Ethernet link settings. The %cmd and
276 * %link_mode_masks_nwords fields should be ignored (use
277 * %__ETHTOOL_LINK_MODE_MASK_NBITS instead of the latter), any
278 * change to them will be overwritten by kernel. Returns a
279 * negative error code or zero.
280 * @set_link_ksettings: When defined, takes precedence over the
281 * %set_settings method. Set various device settings including
282 * Ethernet link settings. The %cmd and %link_mode_masks_nwords
283 * fields should be ignored (use %__ETHTOOL_LINK_MODE_MASK_NBITS
284 * instead of the latter), any change to them will be overwritten
285 * by kernel. Returns a negative error code or zero.
287 * All operations are optional (i.e. the function pointer may be set
288 * to %NULL) and callers must take this into account. Callers must
289 * hold the RTNL lock.
291 * See the structures used by these operations for further documentation.
292 * Note that for all operations using a structure ending with a zero-
293 * length array, the array is allocated separately in the kernel and
294 * is passed to the driver as an additional parameter.
296 * See &struct net_device and &struct net_device_ops for documentation
297 * of the generic netdev features interface.
300 int (*get_settings
)(struct net_device
*, struct ethtool_cmd
*);
301 int (*set_settings
)(struct net_device
*, struct ethtool_cmd
*);
302 void (*get_drvinfo
)(struct net_device
*, struct ethtool_drvinfo
*);
303 int (*get_regs_len
)(struct net_device
*);
304 void (*get_regs
)(struct net_device
*, struct ethtool_regs
*, void *);
305 void (*get_wol
)(struct net_device
*, struct ethtool_wolinfo
*);
306 int (*set_wol
)(struct net_device
*, struct ethtool_wolinfo
*);
307 u32 (*get_msglevel
)(struct net_device
*);
308 void (*set_msglevel
)(struct net_device
*, u32
);
309 int (*nway_reset
)(struct net_device
*);
310 u32 (*get_link
)(struct net_device
*);
311 int (*get_eeprom_len
)(struct net_device
*);
312 int (*get_eeprom
)(struct net_device
*,
313 struct ethtool_eeprom
*, u8
*);
314 int (*set_eeprom
)(struct net_device
*,
315 struct ethtool_eeprom
*, u8
*);
316 int (*get_coalesce
)(struct net_device
*, struct ethtool_coalesce
*);
317 int (*set_coalesce
)(struct net_device
*, struct ethtool_coalesce
*);
318 void (*get_ringparam
)(struct net_device
*,
319 struct ethtool_ringparam
*);
320 int (*set_ringparam
)(struct net_device
*,
321 struct ethtool_ringparam
*);
322 void (*get_pauseparam
)(struct net_device
*,
323 struct ethtool_pauseparam
*);
324 int (*set_pauseparam
)(struct net_device
*,
325 struct ethtool_pauseparam
*);
326 void (*self_test
)(struct net_device
*, struct ethtool_test
*, u64
*);
327 void (*get_strings
)(struct net_device
*, u32 stringset
, u8
*);
328 int (*set_phys_id
)(struct net_device
*, enum ethtool_phys_id_state
);
329 void (*get_ethtool_stats
)(struct net_device
*,
330 struct ethtool_stats
*, u64
*);
331 int (*begin
)(struct net_device
*);
332 void (*complete
)(struct net_device
*);
333 u32 (*get_priv_flags
)(struct net_device
*);
334 int (*set_priv_flags
)(struct net_device
*, u32
);
335 int (*get_sset_count
)(struct net_device
*, int);
336 int (*get_rxnfc
)(struct net_device
*,
337 struct ethtool_rxnfc
*, u32
*rule_locs
);
338 int (*set_rxnfc
)(struct net_device
*, struct ethtool_rxnfc
*);
339 int (*flash_device
)(struct net_device
*, struct ethtool_flash
*);
340 int (*reset
)(struct net_device
*, u32
*);
341 u32 (*get_rxfh_key_size
)(struct net_device
*);
342 u32 (*get_rxfh_indir_size
)(struct net_device
*);
343 int (*get_rxfh
)(struct net_device
*, u32
*indir
, u8
*key
,
345 int (*set_rxfh
)(struct net_device
*, const u32
*indir
,
346 const u8
*key
, const u8 hfunc
);
347 void (*get_channels
)(struct net_device
*, struct ethtool_channels
*);
348 int (*set_channels
)(struct net_device
*, struct ethtool_channels
*);
349 int (*get_dump_flag
)(struct net_device
*, struct ethtool_dump
*);
350 int (*get_dump_data
)(struct net_device
*,
351 struct ethtool_dump
*, void *);
352 int (*set_dump
)(struct net_device
*, struct ethtool_dump
*);
353 int (*get_ts_info
)(struct net_device
*, struct ethtool_ts_info
*);
354 int (*get_module_info
)(struct net_device
*,
355 struct ethtool_modinfo
*);
356 int (*get_module_eeprom
)(struct net_device
*,
357 struct ethtool_eeprom
*, u8
*);
358 int (*get_eee
)(struct net_device
*, struct ethtool_eee
*);
359 int (*set_eee
)(struct net_device
*, struct ethtool_eee
*);
360 int (*get_tunable
)(struct net_device
*,
361 const struct ethtool_tunable
*, void *);
362 int (*set_tunable
)(struct net_device
*,
363 const struct ethtool_tunable
*, const void *);
364 int (*get_per_queue_coalesce
)(struct net_device
*, u32
,
365 struct ethtool_coalesce
*);
366 int (*set_per_queue_coalesce
)(struct net_device
*, u32
,
367 struct ethtool_coalesce
*);
368 int (*get_link_ksettings
)(struct net_device
*,
369 struct ethtool_link_ksettings
*);
370 int (*set_link_ksettings
)(struct net_device
*,
371 const struct ethtool_link_ksettings
*);
373 #endif /* _LINUX_ETHTOOL_H */