[mirror_ubuntu-eoan-kernel.git] / include / linux / ethtool.h

/* SPDX-License-Identifier: GPL-2.0 */
/*
 * ethtool.h: Defines for Linux ethtool.
 *
 * Copyright (C) 1998 David S. Miller (davem@redhat.com)
 * Copyright 2001 Jeff Garzik <jgarzik@pobox.com>
 * Portions Copyright 2001 Sun Microsystems (thockin@sun.com)
 * Portions Copyright 2002 Intel (eli.kupermann@intel.com,
 *                                christopher.leech@intel.com,
 *                                scott.feldman@intel.com)
 * Portions Copyright (C) Sun Microsystems 2008
 */
#ifndef _LINUX_ETHTOOL_H
#define _LINUX_ETHTOOL_H

#include <linux/bitmap.h>
#include <linux/compat.h>
#include <uapi/linux/ethtool.h>

#ifdef CONFIG_COMPAT

struct compat_ethtool_rx_flow_spec {
	u32		flow_type;
	union ethtool_flow_union h_u;
	struct ethtool_flow_ext h_ext;
	union ethtool_flow_union m_u;
	struct ethtool_flow_ext m_ext;
	compat_u64	ring_cookie;
	u32		location;
};

struct compat_ethtool_rxnfc {
	u32				cmd;
	u32				flow_type;
	compat_u64			data;
	struct compat_ethtool_rx_flow_spec fs;
	u32				rule_cnt;
	u32				rule_locs[0];
};

#endif /* CONFIG_COMPAT */

#include <linux/rculist.h>

/**
 * enum ethtool_phys_id_state - indicator state for physical identification
 * @ETHTOOL_ID_INACTIVE: Physical ID indicator should be deactivated
 * @ETHTOOL_ID_ACTIVE: Physical ID indicator should be activated
 * @ETHTOOL_ID_ON: LED should be turned on (used iff %ETHTOOL_ID_ACTIVE
 *	is not supported)
 * @ETHTOOL_ID_OFF: LED should be turned off (used iff %ETHTOOL_ID_ACTIVE
 *	is not supported)
 */
enum ethtool_phys_id_state {
	ETHTOOL_ID_INACTIVE,
	ETHTOOL_ID_ACTIVE,
	ETHTOOL_ID_ON,
	ETHTOOL_ID_OFF
};

enum {
	ETH_RSS_HASH_TOP_BIT, /* Configurable RSS hash function - Toeplitz */
	ETH_RSS_HASH_XOR_BIT, /* Configurable RSS hash function - Xor */
	ETH_RSS_HASH_CRC32_BIT, /* Configurable RSS hash function - Crc32 */

	/*
	 * Add your fresh new hash function bits above and remember to update
	 * rss_hash_func_strings[] in ethtool.c
	 */
	ETH_RSS_HASH_FUNCS_COUNT
};

#define __ETH_RSS_HASH_BIT(bit)	((u32)1 << (bit))
#define __ETH_RSS_HASH(name)	__ETH_RSS_HASH_BIT(ETH_RSS_HASH_##name##_BIT)

#define ETH_RSS_HASH_TOP	__ETH_RSS_HASH(TOP)
#define ETH_RSS_HASH_XOR	__ETH_RSS_HASH(XOR)
#define ETH_RSS_HASH_CRC32	__ETH_RSS_HASH(CRC32)

#define ETH_RSS_HASH_UNKNOWN	0
#define ETH_RSS_HASH_NO_CHANGE	0

struct net_device;

/* Some generic methods drivers may use in their ethtool_ops */
u32 ethtool_op_get_link(struct net_device *dev);
int ethtool_op_get_ts_info(struct net_device *dev, struct ethtool_ts_info *eti);

/**
 * ethtool_rxfh_indir_default - get default value for RX flow hash indirection
 * @index: Index in RX flow hash indirection table
 * @n_rx_rings: Number of RX rings to use
 *
 * This function provides the default policy for RX flow hash indirection.
 */
static inline u32 ethtool_rxfh_indir_default(u32 index, u32 n_rx_rings)
{
	return index % n_rx_rings;
}

/* number of link mode bits/ulongs handled internally by kernel */
#define __ETHTOOL_LINK_MODE_MASK_NBITS			\
	(__ETHTOOL_LINK_MODE_LAST + 1)

/* declare a link mode bitmap */
#define __ETHTOOL_DECLARE_LINK_MODE_MASK(name)		\
	DECLARE_BITMAP(name, __ETHTOOL_LINK_MODE_MASK_NBITS)

/* drivers must ignore base.cmd and base.link_mode_masks_nwords
 * fields, but they are allowed to overwrite them (will be ignored).
 */
struct ethtool_link_ksettings {
	struct ethtool_link_settings base;
	struct {
		__ETHTOOL_DECLARE_LINK_MODE_MASK(supported);
		__ETHTOOL_DECLARE_LINK_MODE_MASK(advertising);
		__ETHTOOL_DECLARE_LINK_MODE_MASK(lp_advertising);
	} link_modes;
};

/**
 * ethtool_link_ksettings_zero_link_mode - clear link_ksettings link mode mask
 *   @ptr : pointer to struct ethtool_link_ksettings
 *   @name : one of supported/advertising/lp_advertising
 */
#define ethtool_link_ksettings_zero_link_mode(ptr, name)		\
	bitmap_zero((ptr)->link_modes.name, __ETHTOOL_LINK_MODE_MASK_NBITS)

/**
 * ethtool_link_ksettings_add_link_mode - set bit in link_ksettings
 * link mode mask
 *   @ptr : pointer to struct ethtool_link_ksettings
 *   @name : one of supported/advertising/lp_advertising
 *   @mode : one of the ETHTOOL_LINK_MODE_*_BIT
 * (not atomic, no bound checking)
 */
#define ethtool_link_ksettings_add_link_mode(ptr, name, mode)		\
	__set_bit(ETHTOOL_LINK_MODE_ ## mode ## _BIT, (ptr)->link_modes.name)

/**
 * ethtool_link_ksettings_del_link_mode - clear bit in link_ksettings
 * link mode mask
 *   @ptr : pointer to struct ethtool_link_ksettings
 *   @name : one of supported/advertising/lp_advertising
 *   @mode : one of the ETHTOOL_LINK_MODE_*_BIT
 * (not atomic, no bound checking)
 */
#define ethtool_link_ksettings_del_link_mode(ptr, name, mode)		\
	__clear_bit(ETHTOOL_LINK_MODE_ ## mode ## _BIT, (ptr)->link_modes.name)

/**
 * ethtool_link_ksettings_test_link_mode - test bit in ksettings link mode mask
 *   @ptr : pointer to struct ethtool_link_ksettings
 *   @name : one of supported/advertising/lp_advertising
 *   @mode : one of the ETHTOOL_LINK_MODE_*_BIT
 * (not atomic, no bound checking)
 *
 * Returns true/false.
 */
#define ethtool_link_ksettings_test_link_mode(ptr, name, mode)		\
	test_bit(ETHTOOL_LINK_MODE_ ## mode ## _BIT, (ptr)->link_modes.name)

extern int
__ethtool_get_link_ksettings(struct net_device *dev,
			     struct ethtool_link_ksettings *link_ksettings);

/**
 * ethtool_intersect_link_masks - Given two link masks, AND them together
 * @dst: first mask and where result is stored
 * @src: second mask to intersect with
 *
 * Given two link mode masks, AND them together and save the result in dst.
 */
void ethtool_intersect_link_masks(struct ethtool_link_ksettings *dst,
				  struct ethtool_link_ksettings *src);

void ethtool_convert_legacy_u32_to_link_mode(unsigned long *dst,
					     u32 legacy_u32);

/* return false if src had higher bits set. lower bits always updated. */
bool ethtool_convert_link_mode_to_legacy_u32(u32 *legacy_u32,
				     const unsigned long *src);

/**
 * struct ethtool_ops - optional netdev operations
 * @get_drvinfo: Report driver/device information.  Should only set the
 *	@driver, @version, @fw_version and @bus_info fields.  If not
 *	implemented, the @driver and @bus_info fields will be filled in
 *	according to the netdev's parent device.
 * @get_regs_len: Get buffer length required for @get_regs
 * @get_regs: Get device registers
 * @get_wol: Report whether Wake-on-Lan is enabled
 * @set_wol: Turn Wake-on-Lan on or off.  Returns a negative error code
 *	or zero.
 * @get_msglevel: Report driver message level.  This should be the value
 *	of the @msg_enable field used by netif logging functions.
 * @set_msglevel: Set driver message level
 * @nway_reset: Restart autonegotiation.  Returns a negative error code
 *	or zero.
 * @get_link: Report whether physical link is up.  Will only be called if
 *	the netdev is up.  Should usually be set to ethtool_op_get_link(),
 *	which uses netif_carrier_ok().
 * @get_eeprom: Read data from the device EEPROM.
 *	Should fill in the magic field.  Don't need to check len for zero
 *	or wraparound.  Fill in the data argument with the eeprom values
 *	from offset to offset + len.  Update len to the amount read.
 *	Returns an error or zero.
 * @set_eeprom: Write data to the device EEPROM.
 *	Should validate the magic field.  Don't need to check len for zero
 *	or wraparound.  Update len to the amount written.  Returns an error
 *	or zero.
 * @get_coalesce: Get interrupt coalescing parameters.  Returns a negative
 *	error code or zero.
 * @set_coalesce: Set interrupt coalescing parameters.  Returns a negative
 *	error code or zero.
 * @get_ringparam: Report ring sizes
 * @set_ringparam: Set ring sizes.  Returns a negative error code or zero.
 * @get_pauseparam: Report pause parameters
 * @set_pauseparam: Set pause parameters.  Returns a negative error code
 *	or zero.
 * @self_test: Run specified self-tests
 * @get_strings: Return a set of strings that describe the requested objects
 * @set_phys_id: Identify the physical devices, e.g. by flashing an LED
 *	attached to it.  The implementation may update the indicator
 *	asynchronously or synchronously, but in either case it must return
 *	quickly.  It is initially called with the argument %ETHTOOL_ID_ACTIVE,
 *	and must either activate asynchronous updates and return zero, return
 *	a negative error or return a positive frequency for synchronous
 *	indication (e.g. 1 for one on/off cycle per second).  If it returns
 *	a frequency then it will be called again at intervals with the
 *	argument %ETHTOOL_ID_ON or %ETHTOOL_ID_OFF and should set the state of
 *	the indicator accordingly.  Finally, it is called with the argument
 *	%ETHTOOL_ID_INACTIVE and must deactivate the indicator.  Returns a
 *	negative error code or zero.
 * @get_ethtool_stats: Return extended statistics about the device.
 *	This is only useful if the device maintains statistics not
 *	included in &struct rtnl_link_stats64.
 * @begin: Function to be called before any other operation.  Returns a
 *	negative error code or zero.
 * @complete: Function to be called after any other operation except
 *	@begin.  Will be called even if the other operation failed.
 * @get_priv_flags: Report driver-specific feature flags.
 * @set_priv_flags: Set driver-specific feature flags.  Returns a negative
 *	error code or zero.
 * @get_sset_count: Get number of strings that @get_strings will write.
 * @get_rxnfc: Get RX flow classification rules.  Returns a negative
 *	error code or zero.
 * @set_rxnfc: Set RX flow classification rules.  Returns a negative
 *	error code or zero.
 * @flash_device: Write a firmware image to device's flash memory.
 *	Returns a negative error code or zero.
 * @reset: Reset (part of) the device, as specified by a bitmask of
 *	flags from &enum ethtool_reset_flags.  Returns a negative
 *	error code or zero.
 * @get_rxfh_key_size: Get the size of the RX flow hash key.
 *	Returns zero if not supported for this specific device.
 * @get_rxfh_indir_size: Get the size of the RX flow hash indirection table.
 *	Returns zero if not supported for this specific device.
 * @get_rxfh: Get the contents of the RX flow hash indirection table, hash key
 *	and/or hash function.
 *	Returns a negative error code or zero.
 * @set_rxfh: Set the contents of the RX flow hash indirection table, hash
 *	key, and/or hash function.  Arguments which are set to %NULL or zero
 *	will remain unchanged.
 *	Returns a negative error code or zero. An error code must be returned
 *	if at least one unsupported change was requested.
 * @get_channels: Get number of channels.
 * @set_channels: Set number of channels.  Returns a negative error code or
 *	zero.
 * @get_dump_flag: Get dump flag indicating current dump length, version,
 * 		   and flag of the device.
 * @get_dump_data: Get dump data.
 * @set_dump: Set dump specific flags to the device.
 * @get_ts_info: Get the time stamping and PTP hardware clock capabilities.
 *	Drivers supporting transmit time stamps in software should set this to
 *	ethtool_op_get_ts_info().
 * @get_module_info: Get the size and type of the eeprom contained within
 *	a plug-in module.
 * @get_module_eeprom: Get the eeprom information from the plug-in module
 * @get_eee: Get Energy-Efficient (EEE) supported and status.
 * @set_eee: Set EEE status (enable/disable) as well as LPI timers.
 * @get_per_queue_coalesce: Get interrupt coalescing parameters per queue.
 *	It must check that the given queue number is valid. If neither a RX nor
 *	a TX queue has this number, return -EINVAL. If only a RX queue or a TX
 *	queue has this number, set the inapplicable fields to ~0 and return 0.
 *	Returns a negative error code or zero.
 * @set_per_queue_coalesce: Set interrupt coalescing parameters per queue.
 *	It must check that the given queue number is valid. If neither a RX nor
 *	a TX queue has this number, return -EINVAL. If only a RX queue or a TX
 *	queue has this number, ignore the inapplicable fields.
 *	Returns a negative error code or zero.
 * @get_link_ksettings: Get various device settings including Ethernet link
 *	settings. The %cmd and %link_mode_masks_nwords fields should be
 *	ignored (use %__ETHTOOL_LINK_MODE_MASK_NBITS instead of the latter),
 *	any change to them will be overwritten by kernel. Returns a negative
 *	error code or zero.
 * @set_link_ksettings: Set various device settings including Ethernet link
 *	settings. The %cmd and %link_mode_masks_nwords fields should be
 *	ignored (use %__ETHTOOL_LINK_MODE_MASK_NBITS instead of the latter),
 *	any change to them will be overwritten by kernel. Returns a negative
 *	error code or zero.
 * @get_fecparam: Get the network device Forward Error Correction parameters.
 * @set_fecparam: Set the network device Forward Error Correction parameters.
 * @get_ethtool_phy_stats: Return extended statistics about the PHY device.
 *	This is only useful if the device maintains PHY statistics and
 *	cannot use the standard PHY library helpers.
 *
 * All operations are optional (i.e. the function pointer may be set
 * to %NULL) and callers must take this into account.  Callers must
 * hold the RTNL lock.
 *
 * See the structures used by these operations for further documentation.
 * Note that for all operations using a structure ending with a zero-
 * length array, the array is allocated separately in the kernel and
 * is passed to the driver as an additional parameter.
 *
 * See &struct net_device and &struct net_device_ops for documentation
 * of the generic netdev features interface.
 */
struct ethtool_ops {
	void	(*get_drvinfo)(struct net_device *, struct ethtool_drvinfo *);
	int	(*get_regs_len)(struct net_device *);
	void	(*get_regs)(struct net_device *, struct ethtool_regs *, void *);
	void	(*get_wol)(struct net_device *, struct ethtool_wolinfo *);
	int	(*set_wol)(struct net_device *, struct ethtool_wolinfo *);
	u32	(*get_msglevel)(struct net_device *);
	void	(*set_msglevel)(struct net_device *, u32);
	int	(*nway_reset)(struct net_device *);
	u32	(*get_link)(struct net_device *);
	int	(*get_eeprom_len)(struct net_device *);
	int	(*get_eeprom)(struct net_device *,
			      struct ethtool_eeprom *, u8 *);
	int	(*set_eeprom)(struct net_device *,
			      struct ethtool_eeprom *, u8 *);
	int	(*get_coalesce)(struct net_device *, struct ethtool_coalesce *);
	int	(*set_coalesce)(struct net_device *, struct ethtool_coalesce *);
	void	(*get_ringparam)(struct net_device *,
				 struct ethtool_ringparam *);
	int	(*set_ringparam)(struct net_device *,
				 struct ethtool_ringparam *);
	void	(*get_pauseparam)(struct net_device *,
				  struct ethtool_pauseparam*);
	int	(*set_pauseparam)(struct net_device *,
				  struct ethtool_pauseparam*);
	void	(*self_test)(struct net_device *, struct ethtool_test *, u64 *);
	void	(*get_strings)(struct net_device *, u32 stringset, u8 *);
	int	(*set_phys_id)(struct net_device *, enum ethtool_phys_id_state);
	void	(*get_ethtool_stats)(struct net_device *,
				     struct ethtool_stats *, u64 *);
	int	(*begin)(struct net_device *);
	void	(*complete)(struct net_device *);
	u32	(*get_priv_flags)(struct net_device *);
	int	(*set_priv_flags)(struct net_device *, u32);
	int	(*get_sset_count)(struct net_device *, int);
	int	(*get_rxnfc)(struct net_device *,
			     struct ethtool_rxnfc *, u32 *rule_locs);
	int	(*set_rxnfc)(struct net_device *, struct ethtool_rxnfc *);
	int	(*flash_device)(struct net_device *, struct ethtool_flash *);
	int	(*reset)(struct net_device *, u32 *);
	u32	(*get_rxfh_key_size)(struct net_device *);
	u32	(*get_rxfh_indir_size)(struct net_device *);
	int	(*get_rxfh)(struct net_device *, u32 *indir, u8 *key,
			    u8 *hfunc);
	int	(*set_rxfh)(struct net_device *, const u32 *indir,
			    const u8 *key, const u8 hfunc);
	int	(*get_rxfh_context)(struct net_device *, u32 *indir, u8 *key,
				    u8 *hfunc, u32 rss_context);
	int	(*set_rxfh_context)(struct net_device *, const u32 *indir,
				    const u8 *key, const u8 hfunc,
				    u32 *rss_context, bool delete);
	void	(*get_channels)(struct net_device *, struct ethtool_channels *);
	int	(*set_channels)(struct net_device *, struct ethtool_channels *);
	int	(*get_dump_flag)(struct net_device *, struct ethtool_dump *);
	int	(*get_dump_data)(struct net_device *,
				 struct ethtool_dump *, void *);
	int	(*set_dump)(struct net_device *, struct ethtool_dump *);
	int	(*get_ts_info)(struct net_device *, struct ethtool_ts_info *);
	int     (*get_module_info)(struct net_device *,
				   struct ethtool_modinfo *);
	int     (*get_module_eeprom)(struct net_device *,
				     struct ethtool_eeprom *, u8 *);
	int	(*get_eee)(struct net_device *, struct ethtool_eee *);
	int	(*set_eee)(struct net_device *, struct ethtool_eee *);
	int	(*get_tunable)(struct net_device *,
			       const struct ethtool_tunable *, void *);
	int	(*set_tunable)(struct net_device *,
			       const struct ethtool_tunable *, const void *);
	int	(*get_per_queue_coalesce)(struct net_device *, u32,
					  struct ethtool_coalesce *);
	int	(*set_per_queue_coalesce)(struct net_device *, u32,
					  struct ethtool_coalesce *);
	int	(*get_link_ksettings)(struct net_device *,
				      struct ethtool_link_ksettings *);
	int	(*set_link_ksettings)(struct net_device *,
				      const struct ethtool_link_ksettings *);
	int	(*get_fecparam)(struct net_device *,
				      struct ethtool_fecparam *);
	int	(*set_fecparam)(struct net_device *,
				      struct ethtool_fecparam *);
	void	(*get_ethtool_phy_stats)(struct net_device *,
					 struct ethtool_stats *, u64 *);
};
#endif /* _LINUX_ETHTOOL_H */
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;
	38	u32 rule_locs[0];
	39	};
	40
	41	#endif /* CONFIG_COMPAT */
c3ce7e20	42
a1467085 DM	43	#include <linux/rculist.h>
a1467085 DM	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
278bc429 BH	89	/**
	90	* ethtool_rxfh_indir_default - get default value for RX flow hash indirection
	91	* @index: Index in RX flow hash indirection table
	92	* @n_rx_rings: Number of RX rings to use
	93	*
	94	* This function provides the default policy for RX flow hash indirection.
	95	*/
	96	static inline u32 ethtool_rxfh_indir_default(u32 index, u32 n_rx_rings)
	97	{
	98	return index % n_rx_rings;
	99	}
	100
3f1ac7a7 DD	101	/* number of link mode bits/ulongs handled internally by kernel */
	102	#define __ETHTOOL_LINK_MODE_MASK_NBITS \
	103	(__ETHTOOL_LINK_MODE_LAST + 1)
	104
	105	/* declare a link mode bitmap */
	106	#define __ETHTOOL_DECLARE_LINK_MODE_MASK(name) \
	107	DECLARE_BITMAP(name, __ETHTOOL_LINK_MODE_MASK_NBITS)
	108
	109	/* drivers must ignore base.cmd and base.link_mode_masks_nwords
	110	* fields, but they are allowed to overwrite them (will be ignored).
	111	*/
	112	struct ethtool_link_ksettings {
	113	struct ethtool_link_settings base;
	114	struct {
	115	__ETHTOOL_DECLARE_LINK_MODE_MASK(supported);
	116	__ETHTOOL_DECLARE_LINK_MODE_MASK(advertising);
	117	__ETHTOOL_DECLARE_LINK_MODE_MASK(lp_advertising);
	118	} link_modes;
	119	};
	120
	121	/**
	122	* ethtool_link_ksettings_zero_link_mode - clear link_ksettings link mode mask
	123	* @ptr : pointer to struct ethtool_link_ksettings
	124	* @name : one of supported/advertising/lp_advertising
	125	*/
	126	#define ethtool_link_ksettings_zero_link_mode(ptr, name) \
	127	bitmap_zero((ptr)->link_modes.name, __ETHTOOL_LINK_MODE_MASK_NBITS)
	128
	129	/**
	130	* ethtool_link_ksettings_add_link_mode - set bit in link_ksettings
	131	* link mode mask
	132	* @ptr : pointer to struct ethtool_link_ksettings
	133	* @name : one of supported/advertising/lp_advertising
	134	* @mode : one of the ETHTOOL_LINK_MODE_*_BIT
	135	* (not atomic, no bound checking)
	136	*/
	137	#define ethtool_link_ksettings_add_link_mode(ptr, name, mode) \
	138	__set_bit(ETHTOOL_LINK_MODE_ ## mode ## _BIT, (ptr)->link_modes.name)
	139
606c07f3 LT	140	/**
	141	* ethtool_link_ksettings_del_link_mode - clear bit in link_ksettings
	142	* link mode mask
	143	* @ptr : pointer to struct ethtool_link_ksettings
	144	* @name : one of supported/advertising/lp_advertising
	145	* @mode : one of the ETHTOOL_LINK_MODE_*_BIT
	146	* (not atomic, no bound checking)
	147	*/
	148	#define ethtool_link_ksettings_del_link_mode(ptr, name, mode) \
	149	__clear_bit(ETHTOOL_LINK_MODE_ ## mode ## _BIT, (ptr)->link_modes.name)
	150
3f1ac7a7 DD	151	/**
	152	* ethtool_link_ksettings_test_link_mode - test bit in ksettings link mode mask
	153	* @ptr : pointer to struct ethtool_link_ksettings
	154	* @name : one of supported/advertising/lp_advertising
	155	* @mode : one of the ETHTOOL_LINK_MODE_*_BIT
	156	* (not atomic, no bound checking)
	157	*
	158	* Returns true/false.
	159	*/
	160	#define ethtool_link_ksettings_test_link_mode(ptr, name, mode) \
	161	test_bit(ETHTOOL_LINK_MODE_ ## mode ## _BIT, (ptr)->link_modes.name)
	162
	163	extern int
	164	__ethtool_get_link_ksettings(struct net_device *dev,
	165	struct ethtool_link_ksettings *link_ksettings);
	166
5a6cd6de AB	167	/**
	168	* ethtool_intersect_link_masks - Given two link masks, AND them together
	169	* @dst: first mask and where result is stored
	170	* @src: second mask to intersect with
	171	*
	172	* Given two link mode masks, AND them together and save the result in dst.
	173	*/
	174	void ethtool_intersect_link_masks(struct ethtool_link_ksettings *dst,
	175	struct ethtool_link_ksettings *src);
	176
6d62b4d5 PR	177	void ethtool_convert_legacy_u32_to_link_mode(unsigned long *dst,
	178	u32 legacy_u32);
	179
	180	/* return false if src had higher bits set. lower bits always updated. */
	181	bool ethtool_convert_link_mode_to_legacy_u32(u32 *legacy_u32,
	182	const unsigned long *src);
	183
1da177e4	184	/**
8717d07b	185	* struct ethtool_ops - optional netdev operations
8717d07b BH	186	* @get_drvinfo: Report driver/device information. Should only set the
	187	* @driver, @version, @fw_version and @bus_info fields. If not
	188	* implemented, the @driver and @bus_info fields will be filled in
	189	* according to the netdev's parent device.
	190	* @get_regs_len: Get buffer length required for @get_regs
e20b5b61 BH	191	* @get_regs: Get device registers
e20b5b61 BH	192	* @get_wol: Report whether Wake-on-Lan is enabled
8717d07b BH	193	* @set_wol: Turn Wake-on-Lan on or off. Returns a negative error code
	194	* or zero.
	195	* @get_msglevel: Report driver message level. This should be the value
	196	* of the @msg_enable field used by netif logging functions.
e20b5b61	197	* @set_msglevel: Set driver message level
8717d07b BH	198	* @nway_reset: Restart autonegotiation. Returns a negative error code
	199	* or zero.
	200	* @get_link: Report whether physical link is up. Will only be called if
	201	* the netdev is up. Should usually be set to ethtool_op_get_link(),
	202	* which uses netif_carrier_ok().
e20b5b61	203	* @get_eeprom: Read data from the device EEPROM.
1da177e4 LT	204	* Should fill in the magic field. Don't need to check len for zero
	205	* or wraparound. Fill in the data argument with the eeprom values
	206	* from offset to offset + len. Update len to the amount read.
	207	* Returns an error or zero.
e20b5b61	208	* @set_eeprom: Write data to the device EEPROM.
1da177e4 LT	209	* Should validate the magic field. Don't need to check len for zero
	210	* or wraparound. Update len to the amount written. Returns an error
	211	* or zero.
8717d07b BH	212	* @get_coalesce: Get interrupt coalescing parameters. Returns a negative
	213	* error code or zero.
	214	* @set_coalesce: Set interrupt coalescing parameters. Returns a negative
	215	* error code or zero.
e20b5b61	216	* @get_ringparam: Report ring sizes
8717d07b	217	* @set_ringparam: Set ring sizes. Returns a negative error code or zero.
e20b5b61	218	* @get_pauseparam: Report pause parameters
8717d07b BH	219	* @set_pauseparam: Set pause parameters. Returns a negative error code
8717d07b BH	220	* or zero.
e20b5b61 BH	221	* @self_test: Run specified self-tests
e20b5b61 BH	222	* @get_strings: Return a set of strings that describe the requested objects
68f512f2 BH	223	* @set_phys_id: Identify the physical devices, e.g. by flashing an LED
	224	* attached to it. The implementation may update the indicator
	225	* asynchronously or synchronously, but in either case it must return
	226	* quickly. It is initially called with the argument %ETHTOOL_ID_ACTIVE,
fce55922 AB	227	* and must either activate asynchronous updates and return zero, return
	228	* a negative error or return a positive frequency for synchronous
	229	* indication (e.g. 1 for one on/off cycle per second). If it returns
	230	* a frequency then it will be called again at intervals with the
68f512f2 BH	231	* argument %ETHTOOL_ID_ON or %ETHTOOL_ID_OFF and should set the state of
	232	* the indicator accordingly. Finally, it is called with the argument
	233	* %ETHTOOL_ID_INACTIVE and must deactivate the indicator. Returns a
	234	* negative error code or zero.
8717d07b BH	235	* @get_ethtool_stats: Return extended statistics about the device.
	236	* This is only useful if the device maintains statistics not
	237	* included in &struct rtnl_link_stats64.
	238	* @begin: Function to be called before any other operation. Returns a
	239	* negative error code or zero.
	240	* @complete: Function to be called after any other operation except
	241	* @begin. Will be called even if the other operation failed.
8717d07b BH	242	* @get_priv_flags: Report driver-specific feature flags.
	243	* @set_priv_flags: Set driver-specific feature flags. Returns a negative
	244	* error code or zero.
	245	* @get_sset_count: Get number of strings that @get_strings will write.
	246	* @get_rxnfc: Get RX flow classification rules. Returns a negative
	247	* error code or zero.
	248	* @set_rxnfc: Set RX flow classification rules. Returns a negative
	249	* error code or zero.
	250	* @flash_device: Write a firmware image to device's flash memory.
	251	* Returns a negative error code or zero.
	252	* @reset: Reset (part of) the device, as specified by a bitmask of
	253	* flags from &enum ethtool_reset_flags. Returns a negative
	254	* error code or zero.
3de0b592 VD	255	* @get_rxfh_key_size: Get the size of the RX flow hash key.
3de0b592 VD	256	* Returns zero if not supported for this specific device.
7850f63f BH	257	* @get_rxfh_indir_size: Get the size of the RX flow hash indirection table.
7850f63f BH	258	* Returns zero if not supported for this specific device.
892311f6 EP	259	* @get_rxfh: Get the contents of the RX flow hash indirection table, hash key
892311f6 EP	260	* and/or hash function.
8717d07b	261	* Returns a negative error code or zero.
892311f6 EP	262	* @set_rxfh: Set the contents of the RX flow hash indirection table, hash
	263	* key, and/or hash function. Arguments which are set to %NULL or zero
	264	* will remain unchanged.
	265	* Returns a negative error code or zero. An error code must be returned
	266	* if at least one unsupported change was requested.
8b5933c3	267	* @get_channels: Get number of channels.
	268	* @set_channels: Set number of channels. Returns a negative error code or
	269	* zero.
29dd54b7 AC	270	* @get_dump_flag: Get dump flag indicating current dump length, version,
	271	* and flag of the device.
	272	* @get_dump_data: Get dump data.
	273	* @set_dump: Set dump specific flags to the device.
c8f3a8c3 RC	274	* @get_ts_info: Get the time stamping and PTP hardware clock capabilities.
	275	* Drivers supporting transmit time stamps in software should set this to
	276	* ethtool_op_get_ts_info().
41c3cb6d SH	277	* @get_module_info: Get the size and type of the eeprom contained within
	278	* a plug-in module.
	279	* @get_module_eeprom: Get the eeprom information from the plug-in module
80f12ecc YM	280	* @get_eee: Get Energy-Efficient (EEE) supported and status.
80f12ecc YM	281	* @set_eee: Set EEE status (enable/disable) as well as LPI timers.
421797b1 KL	282	* @get_per_queue_coalesce: Get interrupt coalescing parameters per queue.
	283	* It must check that the given queue number is valid. If neither a RX nor
	284	* a TX queue has this number, return -EINVAL. If only a RX queue or a TX
	285	* queue has this number, set the inapplicable fields to ~0 and return 0.
	286	* Returns a negative error code or zero.
f38d138a KL	287	* @set_per_queue_coalesce: Set interrupt coalescing parameters per queue.
	288	* It must check that the given queue number is valid. If neither a RX nor
	289	* a TX queue has this number, return -EINVAL. If only a RX queue or a TX
	290	* queue has this number, ignore the inapplicable fields.
	291	* Returns a negative error code or zero.
9b300495 MK	292	* @get_link_ksettings: Get various device settings including Ethernet link
	293	* settings. The %cmd and %link_mode_masks_nwords fields should be
	294	* ignored (use %__ETHTOOL_LINK_MODE_MASK_NBITS instead of the latter),
	295	* any change to them will be overwritten by kernel. Returns a negative
	296	* error code or zero.
	297	* @set_link_ksettings: Set various device settings including Ethernet link
	298	* settings. The %cmd and %link_mode_masks_nwords fields should be
	299	* ignored (use %__ETHTOOL_LINK_MODE_MASK_NBITS instead of the latter),
	300	* any change to them will be overwritten by kernel. Returns a negative
	301	* error code or zero.
d805c520 FF	302	* @get_fecparam: Get the network device Forward Error Correction parameters.
d805c520 FF	303	* @set_fecparam: Set the network device Forward Error Correction parameters.
99943382 FF	304	* @get_ethtool_phy_stats: Return extended statistics about the PHY device.
	305	* This is only useful if the device maintains PHY statistics and
	306	* cannot use the standard PHY library helpers.
8717d07b BH	307	*
	308	* All operations are optional (i.e. the function pointer may be set
	309	* to %NULL) and callers must take this into account. Callers must
b4f79e5c	310	* hold the RTNL lock.
8717d07b BH	311	*
8717d07b BH	312	* See the structures used by these operations for further documentation.
6e201c85 BH	313	* Note that for all operations using a structure ending with a zero-
	314	* length array, the array is allocated separately in the kernel and
	315	* is passed to the driver as an additional parameter.
8717d07b BH	316	*
	317	* See &struct net_device and &struct net_device_ops for documentation
	318	* of the generic netdev features interface.
1da177e4 LT	319	*/
1da177e4 LT	320	struct ethtool_ops {
1da177e4 LT	321	void (get_drvinfo)(struct net_device , struct ethtool_drvinfo *);
	322	int (get_regs_len)(struct net_device );
	323	void (get_regs)(struct net_device , struct ethtool_regs , void );
	324	void (get_wol)(struct net_device , struct ethtool_wolinfo *);
	325	int (set_wol)(struct net_device , struct ethtool_wolinfo *);
	326	u32 (get_msglevel)(struct net_device );
	327	void (set_msglevel)(struct net_device , u32);
	328	int (nway_reset)(struct net_device );
	329	u32 (get_link)(struct net_device );
	330	int (get_eeprom_len)(struct net_device );
97f8aefb	331	int (get_eeprom)(struct net_device ,
	332	struct ethtool_eeprom , u8 );
	333	int (set_eeprom)(struct net_device ,
	334	struct ethtool_eeprom , u8 );
1da177e4 LT	335	int (get_coalesce)(struct net_device , struct ethtool_coalesce *);
1da177e4 LT	336	int (set_coalesce)(struct net_device , struct ethtool_coalesce *);
97f8aefb	337	void (get_ringparam)(struct net_device ,
	338	struct ethtool_ringparam *);
	339	int (set_ringparam)(struct net_device ,
	340	struct ethtool_ringparam *);
	341	void (get_pauseparam)(struct net_device ,
	342	struct ethtool_pauseparam*);
	343	int (set_pauseparam)(struct net_device ,
	344	struct ethtool_pauseparam*);
1da177e4 LT	345	void (self_test)(struct net_device , struct ethtool_test , u64 );
1da177e4 LT	346	void (get_strings)(struct net_device , u32 stringset, u8 *);
68f512f2	347	int (set_phys_id)(struct net_device , enum ethtool_phys_id_state);
97f8aefb	348	void (get_ethtool_stats)(struct net_device ,
97f8aefb	349	struct ethtool_stats , u64 );
1da177e4 LT	350	int (begin)(struct net_device );
1da177e4 LT	351	void (complete)(struct net_device );
97f8aefb	352	u32 (get_priv_flags)(struct net_device );
97f8aefb	353	int (set_priv_flags)(struct net_device , u32);
ff03d49f	354	int (get_sset_count)(struct net_device , int);
97f8aefb	355	int (get_rxnfc)(struct net_device ,
815c7db5	356	struct ethtool_rxnfc , u32 rule_locs);
59089d8d	357	int (set_rxnfc)(struct net_device , struct ethtool_rxnfc *);
97f8aefb	358	int (flash_device)(struct net_device , struct ethtool_flash *);
d73d3a8c	359	int (reset)(struct net_device , u32 *);
3de0b592	360	u32 (get_rxfh_key_size)(struct net_device );
7850f63f	361	u32 (get_rxfh_indir_size)(struct net_device );
892311f6 EP	362	int (get_rxfh)(struct net_device , u32 indir, u8 key,
892311f6 EP	363	u8 *hfunc);
33cb0fa7	364	int (set_rxfh)(struct net_device , const u32 *indir,
892311f6	365	const u8 *key, const u8 hfunc);
84a1d9c4 EC	366	int (get_rxfh_context)(struct net_device , u32 indir, u8 key,
	367	u8 *hfunc, u32 rss_context);
	368	int (set_rxfh_context)(struct net_device , const u32 *indir,
	369	const u8 *key, const u8 hfunc,
	370	u32 *rss_context, bool delete);
8b5933c3	371	void (get_channels)(struct net_device , struct ethtool_channels *);
8b5933c3	372	int (set_channels)(struct net_device , struct ethtool_channels *);
29dd54b7 AC	373	int (get_dump_flag)(struct net_device , struct ethtool_dump *);
	374	int (get_dump_data)(struct net_device ,
	375	struct ethtool_dump , void );
	376	int (set_dump)(struct net_device , struct ethtool_dump *);
c8f3a8c3	377	int (get_ts_info)(struct net_device , struct ethtool_ts_info *);
41c3cb6d SH	378	int (get_module_info)(struct net_device ,
	379	struct ethtool_modinfo *);
	380	int (get_module_eeprom)(struct net_device ,
	381	struct ethtool_eeprom , u8 );
80f12ecc YM	382	int (get_eee)(struct net_device , struct ethtool_eee *);
80f12ecc YM	383	int (set_eee)(struct net_device , struct ethtool_eee *);
f0db9b07 GV	384	int (get_tunable)(struct net_device ,
	385	const struct ethtool_tunable , void );
	386	int (set_tunable)(struct net_device ,
	387	const struct ethtool_tunable , const void );
421797b1 KL	388	int (get_per_queue_coalesce)(struct net_device , u32,
421797b1 KL	389	struct ethtool_coalesce *);
f38d138a KL	390	int (set_per_queue_coalesce)(struct net_device , u32,
f38d138a KL	391	struct ethtool_coalesce *);
3f1ac7a7 DD	392	int (get_link_ksettings)(struct net_device ,
	393	struct ethtool_link_ksettings *);
	394	int (set_link_ksettings)(struct net_device ,
	395	const struct ethtool_link_ksettings *);
1a5f3da2 VSR	396	int (get_fecparam)(struct net_device ,
	397	struct ethtool_fecparam *);
	398	int (set_fecparam)(struct net_device ,
	399	struct ethtool_fecparam *);
99943382 FF	400	void (get_ethtool_phy_stats)(struct net_device ,
99943382 FF	401	struct ethtool_stats , u64 );
1da177e4	402	};
1da177e4	403	#endif /* _LINUX_ETHTOOL_H */