ethtool: Specify what kind of coalescing struct ethtool_coalesce covers

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

/*
 * 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

#ifdef __KERNEL__
#include <linux/compat.h>
#endif
#include <linux/types.h>
#include <linux/if_ether.h>

/* This should work for both 32 and 64 bit userland. */
struct ethtool_cmd {
        __u32   cmd;
        __u32   supported;      /* Features this interface supports */
        __u32   advertising;    /* Features this interface advertises */
        __u16   speed;          /* The forced speed (lower bits) in
                                 * Mbps. Please use
                                 * ethtool_cmd_speed()/_set() to
                                 * access it */
        __u8    duplex;         /* Duplex, half or full */
        __u8    port;           /* Which connector port */
        __u8    phy_address;
        __u8    transceiver;    /* Which transceiver to use */
        __u8    autoneg;        /* Enable or disable autonegotiation */
        __u8    mdio_support;
        __u32   maxtxpkt;       /* Tx pkts before generating tx int */
        __u32   maxrxpkt;       /* Rx pkts before generating rx int */
        __u16   speed_hi;       /* The forced speed (upper
                                 * bits) in Mbps. Please use
                                 * ethtool_cmd_speed()/_set() to
                                 * access it */
        __u8    eth_tp_mdix;
        __u8    reserved2;
        __u32   lp_advertising; /* Features the link partner advertises */
        __u32   reserved[2];
};

static inline void ethtool_cmd_speed_set(struct ethtool_cmd *ep,
                                         __u32 speed)
{

        ep->speed = (__u16)speed;
        ep->speed_hi = (__u16)(speed >> 16);
}

static inline __u32 ethtool_cmd_speed(const struct ethtool_cmd *ep)
{
        return (ep->speed_hi << 16) | ep->speed;
}

#define ETHTOOL_FWVERS_LEN      32
#define ETHTOOL_BUSINFO_LEN     32
/* these strings are set to whatever the driver author decides... */
struct ethtool_drvinfo {
        __u32   cmd;
        char    driver[32];     /* driver short name, "tulip", "eepro100" */
        char    version[32];    /* driver version string */
        char    fw_version[ETHTOOL_FWVERS_LEN]; /* firmware version string */
        char    bus_info[ETHTOOL_BUSINFO_LEN];  /* Bus info for this IF. */
                                /* For PCI devices, use pci_name(pci_dev). */
        char    reserved1[32];
        char    reserved2[12];
                                /*
                                 * Some struct members below are filled in
                                 * using ops->get_sset_count().  Obtaining
                                 * this info from ethtool_drvinfo is now
                                 * deprecated; Use ETHTOOL_GSSET_INFO
                                 * instead.
                                 */
        __u32   n_priv_flags;   /* number of flags valid in ETHTOOL_GPFLAGS */
        __u32   n_stats;        /* number of u64's from ETHTOOL_GSTATS */
        __u32   testinfo_len;
        __u32   eedump_len;     /* Size of data from ETHTOOL_GEEPROM (bytes) */
        __u32   regdump_len;    /* Size of data from ETHTOOL_GREGS (bytes) */
};

#define SOPASS_MAX      6
/* wake-on-lan settings */
struct ethtool_wolinfo {
        __u32   cmd;
        __u32   supported;
        __u32   wolopts;
        __u8    sopass[SOPASS_MAX]; /* SecureOn(tm) password */
};

/* for passing single values */
struct ethtool_value {
        __u32   cmd;
        __u32   data;
};

/* for passing big chunks of data */
struct ethtool_regs {
        __u32   cmd;
        __u32   version; /* driver-specific, indicates different chips/revs */
        __u32   len; /* bytes */
        __u8    data[0];
};

/* for passing EEPROM chunks */
struct ethtool_eeprom {
        __u32   cmd;
        __u32   magic;
        __u32   offset; /* in bytes */
        __u32   len; /* in bytes */
        __u8    data[0];
};

/**
 * struct ethtool_coalesce - coalescing parameters for IRQs and stats updates
 * @cmd: ETHTOOL_{G,S}COALESCE
 * @rx_coalesce_usecs: How many usecs to delay an RX interrupt after
 *      a packet arrives.  If 0, only @rx_max_coalesced_frames is used.
 * @rx_max_coalesced_frames: How many packets to delay an RX interrupt
 *      after a packet arrives.  If 0, only @rx_coalesce_usecs is used.
 * @rx_coalesce_usecs_irq: Same as @rx_coalesce_usecs, except that
 *      this value applies while an IRQ is being serviced by the host.
 * @rx_max_coalesced_frames_irq: Same as @rx_max_coalesced_frames,
 *      except that this value applies while an IRQ is being serviced
 *      by the host.
 * @tx_coalesce_usecs: How many usecs to delay a TX interrupt after
 *      a packet is sent.  If 0, only @tx_max_coalesced_frames
 *      is used.
 * @tx_max_coalesced_frames: How many packets to delay a TX interrupt
 *      after a packet is sent.  If 0, only @tx_coalesce_usecs is
 *      used.
 * @tx_coalesce_usecs_irq: Same as @tx_coalesce_usecs, except that
 *      this value applies while an IRQ is being serviced by the host.
 * @tx_max_coalesced_frames_irq: Same as @tx_max_coalesced_frames,
 *      except that this value applies while an IRQ is being serviced
 *      by the host.
 * @stats_block_coalesce_usecs: How many usecs to delay in-memory
 *      statistics block updates.  Some drivers do not have an
 *      in-memory statistic block, and in such cases this value is
 *      ignored.  This value must not be zero.
 * @use_adaptive_rx_coalesce: Enable adaptive RX coalescing.
 * @use_adaptive_tx_coalesce: Enable adaptive TX coalescing.
 * @pkt_rate_low: Threshold for low packet rate (packets per second).
 * @rx_coalesce_usecs_low: How many usecs to delay an RX interrupt after
 *      a packet arrives, when the packet rate is below @pkt_rate_low.
 * @rx_max_coalesced_frames_low: How many packets to delay an RX interrupt
 *      after a packet arrives, when the packet rate is below @pkt_rate_low.
 * @tx_coalesce_usecs_low: How many usecs to delay a TX interrupt after
 *      a packet is sent, when the packet rate is below @pkt_rate_low.
 * @tx_max_coalesced_frames_low: How many packets to delay a TX interrupt
 *      after a packet is sent, when the packet rate is below @pkt_rate_low.
 * @pkt_rate_high: Threshold for high packet rate (packets per second).
 * @rx_coalesce_usecs_high: How many usecs to delay an RX interrupt after
 *      a packet arrives, when the packet rate is above @pkt_rate_high.
 * @rx_max_coalesced_frames_high: How many packets to delay an RX interrupt
 *      after a packet arrives, when the packet rate is above @pkt_rate_high.
 * @tx_coalesce_usecs_high: How many usecs to delay a TX interrupt after
 *      a packet is sent, when the packet rate is above @pkt_rate_high.
 * @tx_max_coalesced_frames_high: How many packets to delay a TX interrupt
 *      after a packet is sent, when the packet rate is above @pkt_rate_high.
 * @rate_sample_interval: How often to do adaptive coalescing packet rate
 *      sampling, measured in seconds.  Must not be zero.
 *
 * It is illegal to set both usecs and max frames to zero as this
 * would cause interrupts to never be generated.
 *
 * Adaptive RX/TX coalescing is an algorithm implemented by some
 * drivers to improve latency under low packet rates and improve
 * throughput under high packet rates.  Some drivers only implement
 * one of RX or TX adaptive coalescing.  Anything not implemented by
 * the driver causes these values to be silently ignored.
 *
 * When the packet rate is below @pkt_rate_high but above
 * @pkt_rate_low (both measured in packets per second) the
 * normal {rx,tx}_* coalescing parameters are used.
 */
struct ethtool_coalesce {
        __u32   cmd;
        __u32   rx_coalesce_usecs;
        __u32   rx_max_coalesced_frames;
        __u32   rx_coalesce_usecs_irq;
        __u32   rx_max_coalesced_frames_irq;
        __u32   tx_coalesce_usecs;
        __u32   tx_max_coalesced_frames;
        __u32   tx_coalesce_usecs_irq;
        __u32   tx_max_coalesced_frames_irq;
        __u32   stats_block_coalesce_usecs;
        __u32   use_adaptive_rx_coalesce;
        __u32   use_adaptive_tx_coalesce;
        __u32   pkt_rate_low;
        __u32   rx_coalesce_usecs_low;
        __u32   rx_max_coalesced_frames_low;
        __u32   tx_coalesce_usecs_low;
        __u32   tx_max_coalesced_frames_low;
        __u32   pkt_rate_high;
        __u32   rx_coalesce_usecs_high;
        __u32   rx_max_coalesced_frames_high;
        __u32   tx_coalesce_usecs_high;
        __u32   tx_max_coalesced_frames_high;
        __u32   rate_sample_interval;
};

/* for configuring RX/TX ring parameters */
struct ethtool_ringparam {
        __u32   cmd;    /* ETHTOOL_{G,S}RINGPARAM */

        /* Read only attributes.  These indicate the maximum number
         * of pending RX/TX ring entries the driver will allow the
         * user to set.
         */
        __u32   rx_max_pending;
        __u32   rx_mini_max_pending;
        __u32   rx_jumbo_max_pending;
        __u32   tx_max_pending;

        /* Values changeable by the user.  The valid values are
         * in the range 1 to the "*_max_pending" counterpart above.
         */
        __u32   rx_pending;
        __u32   rx_mini_pending;
        __u32   rx_jumbo_pending;
        __u32   tx_pending;
};

/**
 * struct ethtool_channels - configuring number of network channel
 * @cmd: ETHTOOL_{G,S}CHANNELS
 * @max_rx: Read only. Maximum number of receive channel the driver support.
 * @max_tx: Read only. Maximum number of transmit channel the driver support.
 * @max_other: Read only. Maximum number of other channel the driver support.
 * @max_combined: Read only. Maximum number of combined channel the driver
 *      support. Set of queues RX, TX or other.
 * @rx_count: Valid values are in the range 1 to the max_rx.
 * @tx_count: Valid values are in the range 1 to the max_tx.
 * @other_count: Valid values are in the range 1 to the max_other.
 * @combined_count: Valid values are in the range 1 to the max_combined.
 *
 * This can be used to configure RX, TX and other channels.
 */

struct ethtool_channels {
        __u32   cmd;
        __u32   max_rx;
        __u32   max_tx;
        __u32   max_other;
        __u32   max_combined;
        __u32   rx_count;
        __u32   tx_count;
        __u32   other_count;
        __u32   combined_count;
};

/* for configuring link flow control parameters */
struct ethtool_pauseparam {
        __u32   cmd;    /* ETHTOOL_{G,S}PAUSEPARAM */

        /* If the link is being auto-negotiated (via ethtool_cmd.autoneg
         * being true) the user may set 'autoneg' here non-zero to have the
         * pause parameters be auto-negotiated too.  In such a case, the
         * {rx,tx}_pause values below determine what capabilities are
         * advertised.
         *
         * If 'autoneg' is zero or the link is not being auto-negotiated,
         * then {rx,tx}_pause force the driver to use/not-use pause
         * flow control.
         */
        __u32   autoneg;
        __u32   rx_pause;
        __u32   tx_pause;
};

#define ETH_GSTRING_LEN         32
enum ethtool_stringset {
        ETH_SS_TEST             = 0,
        ETH_SS_STATS,
        ETH_SS_PRIV_FLAGS,
        ETH_SS_NTUPLE_FILTERS,  /* Do not use, GRXNTUPLE is now deprecated */
        ETH_SS_FEATURES,
};

/* for passing string sets for data tagging */
struct ethtool_gstrings {
        __u32   cmd;            /* ETHTOOL_GSTRINGS */
        __u32   string_set;     /* string set id e.c. ETH_SS_TEST, etc*/
        __u32   len;            /* number of strings in the string set */
        __u8    data[0];
};

struct ethtool_sset_info {
        __u32   cmd;            /* ETHTOOL_GSSET_INFO */
        __u32   reserved;
        __u64   sset_mask;      /* input: each bit selects an sset to query */
                                /* output: each bit a returned sset */
        __u32   data[0];        /* ETH_SS_xxx count, in order, based on bits
                                   in sset_mask.  One bit implies one
                                   __u32, two bits implies two
                                   __u32's, etc. */
};

/**
 * enum ethtool_test_flags - flags definition of ethtool_test
 * @ETH_TEST_FL_OFFLINE: if set perform online and offline tests, otherwise
 *      only online tests.
 * @ETH_TEST_FL_FAILED: Driver set this flag if test fails.
 * @ETH_TEST_FL_EXTERNAL_LB: Application request to perform external loopback
 *      test.
 * @ETH_TEST_FL_EXTERNAL_LB_DONE: Driver performed the external loopback test
 */

enum ethtool_test_flags {
        ETH_TEST_FL_OFFLINE     = (1 << 0),
        ETH_TEST_FL_FAILED      = (1 << 1),
        ETH_TEST_FL_EXTERNAL_LB = (1 << 2),
        ETH_TEST_FL_EXTERNAL_LB_DONE    = (1 << 3),
};

/* for requesting NIC test and getting results*/
struct ethtool_test {
        __u32   cmd;            /* ETHTOOL_TEST */
        __u32   flags;          /* ETH_TEST_FL_xxx */
        __u32   reserved;
        __u32   len;            /* result length, in number of u64 elements */
        __u64   data[0];
};

/* for dumping NIC-specific statistics */
struct ethtool_stats {
        __u32   cmd;            /* ETHTOOL_GSTATS */
        __u32   n_stats;        /* number of u64's being returned */
        __u64   data[0];
};

struct ethtool_perm_addr {
        __u32   cmd;            /* ETHTOOL_GPERMADDR */
        __u32   size;
        __u8    data[0];
};

/* boolean flags controlling per-interface behavior characteristics.
 * When reading, the flag indicates whether or not a certain behavior
 * is enabled/present.  When writing, the flag indicates whether
 * or not the driver should turn on (set) or off (clear) a behavior.
 *
 * Some behaviors may read-only (unconditionally absent or present).
 * If such is the case, return EINVAL in the set-flags operation if the
 * flag differs from the read-only value.
 */
enum ethtool_flags {
        ETH_FLAG_TXVLAN         = (1 << 7),     /* TX VLAN offload enabled */
        ETH_FLAG_RXVLAN         = (1 << 8),     /* RX VLAN offload enabled */
        ETH_FLAG_LRO            = (1 << 15),    /* LRO is enabled */
        ETH_FLAG_NTUPLE         = (1 << 27),    /* N-tuple filters enabled */
        ETH_FLAG_RXHASH         = (1 << 28),
};

/* The following structures are for supporting RX network flow
 * classification and RX n-tuple configuration. Note, all multibyte
 * fields, e.g., ip4src, ip4dst, psrc, pdst, spi, etc. are expected to
 * be in network byte order.
 */

/**
 * struct ethtool_tcpip4_spec - flow specification for TCP/IPv4 etc.
 * @ip4src: Source host
 * @ip4dst: Destination host
 * @psrc: Source port
 * @pdst: Destination port
 * @tos: Type-of-service
 *
 * This can be used to specify a TCP/IPv4, UDP/IPv4 or SCTP/IPv4 flow.
 */
struct ethtool_tcpip4_spec {
        __be32  ip4src;
        __be32  ip4dst;
        __be16  psrc;
        __be16  pdst;
        __u8    tos;
};

/**
 * struct ethtool_ah_espip4_spec - flow specification for IPsec/IPv4
 * @ip4src: Source host
 * @ip4dst: Destination host
 * @spi: Security parameters index
 * @tos: Type-of-service
 *
 * This can be used to specify an IPsec transport or tunnel over IPv4.
 */
struct ethtool_ah_espip4_spec {
        __be32  ip4src;
        __be32  ip4dst;
        __be32  spi;
        __u8    tos;
};

#define ETH_RX_NFC_IP4  1

/**
 * struct ethtool_usrip4_spec - general flow specification for IPv4
 * @ip4src: Source host
 * @ip4dst: Destination host
 * @l4_4_bytes: First 4 bytes of transport (layer 4) header
 * @tos: Type-of-service
 * @ip_ver: Value must be %ETH_RX_NFC_IP4; mask must be 0
 * @proto: Transport protocol number; mask must be 0
 */
struct ethtool_usrip4_spec {
        __be32  ip4src;
        __be32  ip4dst;
        __be32  l4_4_bytes;
        __u8    tos;
        __u8    ip_ver;
        __u8    proto;
};

union ethtool_flow_union {
        struct ethtool_tcpip4_spec              tcp_ip4_spec;
        struct ethtool_tcpip4_spec              udp_ip4_spec;
        struct ethtool_tcpip4_spec              sctp_ip4_spec;
        struct ethtool_ah_espip4_spec           ah_ip4_spec;
        struct ethtool_ah_espip4_spec           esp_ip4_spec;
        struct ethtool_usrip4_spec              usr_ip4_spec;
        struct ethhdr                           ether_spec;
        __u8                                    hdata[60];
};

struct ethtool_flow_ext {
        __be16  vlan_etype;
        __be16  vlan_tci;
        __be32  data[2];
};

/**
 * struct ethtool_rx_flow_spec - specification for RX flow filter
 * @flow_type: Type of match to perform, e.g. %TCP_V4_FLOW
 * @h_u: Flow fields to match (dependent on @flow_type)
 * @h_ext: Additional fields to match
 * @m_u: Masks for flow field bits to be matched
 * @m_ext: Masks for additional field bits to be matched
 *      Note, all additional fields must be ignored unless @flow_type
 *      includes the %FLOW_EXT flag.
 * @ring_cookie: RX ring/queue index to deliver to, or %RX_CLS_FLOW_DISC
 *      if packets should be discarded
 * @location: Index of filter in hardware table
 */
struct 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;
        __u64           ring_cookie;
        __u32           location;
};

/**
 * struct ethtool_rxnfc - command to get or set RX flow classification rules
 * @cmd: Specific command number - %ETHTOOL_GRXFH, %ETHTOOL_SRXFH,
 *      %ETHTOOL_GRXRINGS, %ETHTOOL_GRXCLSRLCNT, %ETHTOOL_GRXCLSRULE,
 *      %ETHTOOL_GRXCLSRLALL, %ETHTOOL_SRXCLSRLDEL or %ETHTOOL_SRXCLSRLINS
 * @flow_type: Type of flow to be affected, e.g. %TCP_V4_FLOW
 * @data: Command-dependent value
 * @fs: Flow filter specification
 * @rule_cnt: Number of rules to be affected
 * @rule_locs: Array of valid rule indices
 *
 * For %ETHTOOL_GRXFH and %ETHTOOL_SRXFH, @data is a bitmask indicating
 * the fields included in the flow hash, e.g. %RXH_IP_SRC.  The following
 * structure fields must not be used.
 *
 * For %ETHTOOL_GRXRINGS, @data is set to the number of RX rings/queues
 * on return.
 *
 * For %ETHTOOL_GRXCLSRLCNT, @rule_cnt is set to the number of defined
 * rules on return.
 *
 * For %ETHTOOL_GRXCLSRULE, @fs.@location specifies the index of an
 * existing filter rule on entry and @fs contains the rule on return.
 *
 * For %ETHTOOL_GRXCLSRLALL, @rule_cnt specifies the array size of the
 * user buffer for @rule_locs on entry.  On return, @data is the size
 * of the filter table and @rule_locs contains the indices of the
 * defined rules.
 *
 * For %ETHTOOL_SRXCLSRLINS, @fs specifies the filter rule to add or
 * update.  @fs.@location specifies the index to use and must not be
 * ignored.
 *
 * For %ETHTOOL_SRXCLSRLDEL, @fs.@location specifies the index of an
 * existing filter rule on entry.
 *
 * Implementation of indexed classification rules generally requires a
 * TCAM.
 */
struct ethtool_rxnfc {
        __u32                           cmd;
        __u32                           flow_type;
        __u64                           data;
        struct ethtool_rx_flow_spec     fs;
        __u32                           rule_cnt;
        __u32                           rule_locs[0];
};

#ifdef __KERNEL__
#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 */
#endif /* __KERNEL__ */

/**
 * struct ethtool_rxfh_indir - command to get or set RX flow hash indirection
 * @cmd: Specific command number - %ETHTOOL_GRXFHINDIR or %ETHTOOL_SRXFHINDIR
 * @size: On entry, the array size of the user buffer.  On return from
 *      %ETHTOOL_GRXFHINDIR, the array size of the hardware indirection table.
 * @ring_index: RX ring/queue index for each hash value
 */
struct ethtool_rxfh_indir {
        __u32   cmd;
        __u32   size;
        __u32   ring_index[0];
};

/**
 * struct ethtool_rx_ntuple_flow_spec - specification for RX flow filter
 * @flow_type: Type of match to perform, e.g. %TCP_V4_FLOW
 * @h_u: Flow field values to match (dependent on @flow_type)
 * @m_u: Masks for flow field value bits to be ignored
 * @vlan_tag: VLAN tag to match
 * @vlan_tag_mask: Mask for VLAN tag bits to be ignored
 * @data: Driver-dependent data to match
 * @data_mask: Mask for driver-dependent data bits to be ignored
 * @action: RX ring/queue index to deliver to (non-negative) or other action
 *      (negative, e.g. %ETHTOOL_RXNTUPLE_ACTION_DROP)
 *
 * For flow types %TCP_V4_FLOW, %UDP_V4_FLOW and %SCTP_V4_FLOW, where
 * a field value and mask are both zero this is treated as if all mask
 * bits are set i.e. the field is ignored.
 */
struct ethtool_rx_ntuple_flow_spec {
        __u32            flow_type;
        union {
                struct ethtool_tcpip4_spec              tcp_ip4_spec;
                struct ethtool_tcpip4_spec              udp_ip4_spec;
                struct ethtool_tcpip4_spec              sctp_ip4_spec;
                struct ethtool_ah_espip4_spec           ah_ip4_spec;
                struct ethtool_ah_espip4_spec           esp_ip4_spec;
                struct ethtool_usrip4_spec              usr_ip4_spec;
                struct ethhdr                           ether_spec;
                __u8                                    hdata[72];
        } h_u, m_u;

        __u16           vlan_tag;
        __u16           vlan_tag_mask;
        __u64           data;
        __u64           data_mask;

        __s32           action;
#define ETHTOOL_RXNTUPLE_ACTION_DROP    (-1)    /* drop packet */
#define ETHTOOL_RXNTUPLE_ACTION_CLEAR   (-2)    /* clear filter */
};

/**
 * struct ethtool_rx_ntuple - command to set or clear RX flow filter
 * @cmd: Command number - %ETHTOOL_SRXNTUPLE
 * @fs: Flow filter specification
 */
struct ethtool_rx_ntuple {
        __u32                                   cmd;
        struct ethtool_rx_ntuple_flow_spec      fs;
};

#define ETHTOOL_FLASH_MAX_FILENAME      128
enum ethtool_flash_op_type {
        ETHTOOL_FLASH_ALL_REGIONS       = 0,
};

/* for passing firmware flashing related parameters */
struct ethtool_flash {
        __u32   cmd;
        __u32   region;
        char    data[ETHTOOL_FLASH_MAX_FILENAME];
};

/**
 * struct ethtool_dump - used for retrieving, setting device dump
 * @cmd: Command number - %ETHTOOL_GET_DUMP_FLAG, %ETHTOOL_GET_DUMP_DATA, or
 *      %ETHTOOL_SET_DUMP
 * @version: FW version of the dump, filled in by driver
 * @flag: driver dependent flag for dump setting, filled in by driver during
 *        get and filled in by ethtool for set operation
 * @len: length of dump data, used as the length of the user buffer on entry to
 *       %ETHTOOL_GET_DUMP_DATA and this is returned as dump length by driver
 *       for %ETHTOOL_GET_DUMP_FLAG command
 * @data: data collected for get dump data operation
 */
struct ethtool_dump {
        __u32   cmd;
        __u32   version;
        __u32   flag;
        __u32   len;
        __u8    data[0];
};

/* for returning and changing feature sets */

/**
 * struct ethtool_get_features_block - block with state of 32 features
 * @available: mask of changeable features
 * @requested: mask of features requested to be enabled if possible
 * @active: mask of currently enabled features
 * @never_changed: mask of features not changeable for any device
 */
struct ethtool_get_features_block {
        __u32   available;
        __u32   requested;
        __u32   active;
        __u32   never_changed;
};

/**
 * struct ethtool_gfeatures - command to get state of device's features
 * @cmd: command number = %ETHTOOL_GFEATURES
 * @size: in: number of elements in the features[] array;
 *       out: number of elements in features[] needed to hold all features
 * @features: state of features
 */
struct ethtool_gfeatures {
        __u32   cmd;
        __u32   size;
        struct ethtool_get_features_block features[0];
};

/**
 * struct ethtool_set_features_block - block with request for 32 features
 * @valid: mask of features to be changed
 * @requested: values of features to be changed
 */
struct ethtool_set_features_block {
        __u32   valid;
        __u32   requested;
};

/**
 * struct ethtool_sfeatures - command to request change in device's features
 * @cmd: command number = %ETHTOOL_SFEATURES
 * @size: array size of the features[] array
 * @features: feature change masks
 */
struct ethtool_sfeatures {
        __u32   cmd;
        __u32   size;
        struct ethtool_set_features_block features[0];
};

/*
 * %ETHTOOL_SFEATURES changes features present in features[].valid to the
 * values of corresponding bits in features[].requested. Bits in .requested
 * not set in .valid or not changeable are ignored.
 *
 * Returns %EINVAL when .valid contains undefined or never-changeable bits
 * or size is not equal to required number of features words (32-bit blocks).
 * Returns >= 0 if request was completed; bits set in the value mean:
 *   %ETHTOOL_F_UNSUPPORTED - there were bits set in .valid that are not
 *      changeable (not present in %ETHTOOL_GFEATURES' features[].available)
 *      those bits were ignored.
 *   %ETHTOOL_F_WISH - some or all changes requested were recorded but the
 *      resulting state of bits masked by .valid is not equal to .requested.
 *      Probably there are other device-specific constraints on some features
 *      in the set. When %ETHTOOL_F_UNSUPPORTED is set, .valid is considered
 *      here as though ignored bits were cleared.
 *   %ETHTOOL_F_COMPAT - some or all changes requested were made by calling
 *      compatibility functions. Requested offload state cannot be properly
 *      managed by kernel.
 *
 * Meaning of bits in the masks are obtained by %ETHTOOL_GSSET_INFO (number of
 * bits in the arrays - always multiple of 32) and %ETHTOOL_GSTRINGS commands
 * for ETH_SS_FEATURES string set. First entry in the table corresponds to least
 * significant bit in features[0] fields. Empty strings mark undefined features.
 */
enum ethtool_sfeatures_retval_bits {
        ETHTOOL_F_UNSUPPORTED__BIT,
        ETHTOOL_F_WISH__BIT,
        ETHTOOL_F_COMPAT__BIT,
};

#define ETHTOOL_F_UNSUPPORTED   (1 << ETHTOOL_F_UNSUPPORTED__BIT)
#define ETHTOOL_F_WISH          (1 << ETHTOOL_F_WISH__BIT)
#define ETHTOOL_F_COMPAT        (1 << ETHTOOL_F_COMPAT__BIT)

#ifdef __KERNEL__

#include <linux/rculist.h>

/* needed by dev_disable_lro() */
extern int __ethtool_set_flags(struct net_device *dev, u32 flags);

/**
 * 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
};

struct net_device;

/* Some generic methods drivers may use in their ethtool_ops */
u32 ethtool_op_get_link(struct net_device *dev);
u32 ethtool_op_get_tx_csum(struct net_device *dev);
int ethtool_op_set_tx_csum(struct net_device *dev, u32 data);
int ethtool_op_set_tx_hw_csum(struct net_device *dev, u32 data);
int ethtool_op_set_tx_ipv6_csum(struct net_device *dev, u32 data);
u32 ethtool_op_get_sg(struct net_device *dev);
int ethtool_op_set_sg(struct net_device *dev, u32 data);
u32 ethtool_op_get_tso(struct net_device *dev);
int ethtool_op_set_tso(struct net_device *dev, u32 data);
u32 ethtool_op_get_ufo(struct net_device *dev);
int ethtool_op_set_ufo(struct net_device *dev, u32 data);
u32 ethtool_op_get_flags(struct net_device *dev);
int ethtool_op_set_flags(struct net_device *dev, u32 data, u32 supported);
bool ethtool_invalid_flags(struct net_device *dev, u32 data, u32 supported);

/**
 * struct ethtool_ops - optional netdev operations
 * @get_settings: Get various device settings including Ethernet link
 *      settings. The @cmd parameter is expected to have been cleared
 *      before get_settings is called. Returns a negative error code or
 *      zero.
 * @set_settings: Set various device settings including Ethernet link
 *      settings.  Returns a negative error code or zero.
 * @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.
 * @get_rx_csum: Deprecated in favour of the netdev feature %NETIF_F_RXCSUM.
 *      Report whether receive checksums are turned on or off.
 * @set_rx_csum: Deprecated in favour of generic netdev features.  Turn
 *      receive checksum on or off.  Returns a negative error code or zero.
 * @get_tx_csum: Deprecated as redundant. Report whether transmit checksums
 *      are turned on or off.
 * @set_tx_csum: Deprecated in favour of generic netdev features.  Turn
 *      transmit checksums on or off.  Returns a negative error code or zero.
 * @get_sg: Deprecated as redundant.  Report whether scatter-gather is
 *      enabled.  
 * @set_sg: Deprecated in favour of generic netdev features.  Turn
 *      scatter-gather on or off. Returns a negative error code or zero.
 * @get_tso: Deprecated as redundant.  Report whether TCP segmentation
 *      offload is enabled.
 * @set_tso: Deprecated in favour of generic netdev features.  Turn TCP
 *      segmentation offload on or off.  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_ufo: Deprecated as redundant.  Report whether UDP fragmentation
 *      offload is enabled.
 * @set_ufo: Deprecated in favour of generic netdev features.  Turn UDP
 *      fragmentation offload on or off.  Returns a negative error code or zero.
 * @get_flags: Deprecated as redundant.  Report features included in
 *      &enum ethtool_flags that are enabled.  
 * @set_flags: Deprecated in favour of generic netdev features.  Turn
 *      features included in &enum ethtool_flags on or off.  Returns a
 *      negative error code or zero.
 * @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.
 * @set_rx_ntuple: Set an RX n-tuple rule.  Returns a negative error code
 *      or zero.
 * @get_rxfh_indir: Get the contents of the RX flow hash indirection table.
 *      Returns a negative error code or zero.
 * @set_rxfh_indir: Set the contents of the RX flow hash indirection table.
 *      Returns a negative error code or zero.
 * @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.
 *
 * 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, except that for @get_drvinfo the caller may or may
 * not hold the RTNL.
 *
 * See the structures used by these operations for further documentation.
 *
 * See &struct net_device and &struct net_device_ops for documentation
 * of the generic netdev features interface.
 */
struct ethtool_ops {
        int     (*get_settings)(struct net_device *, struct ethtool_cmd *);
        int     (*set_settings)(struct net_device *, struct ethtool_cmd *);
        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*);
        u32     (*get_rx_csum)(struct net_device *);
        int     (*set_rx_csum)(struct net_device *, u32);
        u32     (*get_tx_csum)(struct net_device *);
        int     (*set_tx_csum)(struct net_device *, u32);
        u32     (*get_sg)(struct net_device *);
        int     (*set_sg)(struct net_device *, u32);
        u32     (*get_tso)(struct net_device *);
        int     (*set_tso)(struct net_device *, u32);
        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_ufo)(struct net_device *);
        int     (*set_ufo)(struct net_device *, u32);
        u32     (*get_flags)(struct net_device *);
        int     (*set_flags)(struct net_device *, u32);
        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 *, void *);
        int     (*set_rxnfc)(struct net_device *, struct ethtool_rxnfc *);
        int     (*flash_device)(struct net_device *, struct ethtool_flash *);
        int     (*reset)(struct net_device *, u32 *);
        int     (*set_rx_ntuple)(struct net_device *,
                                 struct ethtool_rx_ntuple *);
        int     (*get_rxfh_indir)(struct net_device *,
                                  struct ethtool_rxfh_indir *);
        int     (*set_rxfh_indir)(struct net_device *,
                                  const struct ethtool_rxfh_indir *);
        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 *);

};
#endif /* __KERNEL__ */

/* CMDs currently supported */
#define ETHTOOL_GSET            0x00000001 /* Get settings. */
#define ETHTOOL_SSET            0x00000002 /* Set settings. */
#define ETHTOOL_GDRVINFO        0x00000003 /* Get driver info. */
#define ETHTOOL_GREGS           0x00000004 /* Get NIC registers. */
#define ETHTOOL_GWOL            0x00000005 /* Get wake-on-lan options. */
#define ETHTOOL_SWOL            0x00000006 /* Set wake-on-lan options. */
#define ETHTOOL_GMSGLVL         0x00000007 /* Get driver message level */
#define ETHTOOL_SMSGLVL         0x00000008 /* Set driver msg level. */
#define ETHTOOL_NWAY_RST        0x00000009 /* Restart autonegotiation. */
/* Get link status for host, i.e. whether the interface *and* the
 * physical port (if there is one) are up (ethtool_value). */
#define ETHTOOL_GLINK           0x0000000a
#define ETHTOOL_GEEPROM         0x0000000b /* Get EEPROM data */
#define ETHTOOL_SEEPROM         0x0000000c /* Set EEPROM data. */
#define ETHTOOL_GCOALESCE       0x0000000e /* Get coalesce config */
#define ETHTOOL_SCOALESCE       0x0000000f /* Set coalesce config. */
#define ETHTOOL_GRINGPARAM      0x00000010 /* Get ring parameters */
#define ETHTOOL_SRINGPARAM      0x00000011 /* Set ring parameters. */
#define ETHTOOL_GPAUSEPARAM     0x00000012 /* Get pause parameters */
#define ETHTOOL_SPAUSEPARAM     0x00000013 /* Set pause parameters. */
#define ETHTOOL_GRXCSUM         0x00000014 /* Get RX hw csum enable (ethtool_value) */
#define ETHTOOL_SRXCSUM         0x00000015 /* Set RX hw csum enable (ethtool_value) */
#define ETHTOOL_GTXCSUM         0x00000016 /* Get TX hw csum enable (ethtool_value) */
#define ETHTOOL_STXCSUM         0x00000017 /* Set TX hw csum enable (ethtool_value) */
#define ETHTOOL_GSG             0x00000018 /* Get scatter-gather enable
                                            * (ethtool_value) */
#define ETHTOOL_SSG             0x00000019 /* Set scatter-gather enable
                                            * (ethtool_value). */
#define ETHTOOL_TEST            0x0000001a /* execute NIC self-test. */
#define ETHTOOL_GSTRINGS        0x0000001b /* get specified string set */
#define ETHTOOL_PHYS_ID         0x0000001c /* identify the NIC */
#define ETHTOOL_GSTATS          0x0000001d /* get NIC-specific statistics */
#define ETHTOOL_GTSO            0x0000001e /* Get TSO enable (ethtool_value) */
#define ETHTOOL_STSO            0x0000001f /* Set TSO enable (ethtool_value) */
#define ETHTOOL_GPERMADDR       0x00000020 /* Get permanent hardware address */
#define ETHTOOL_GUFO            0x00000021 /* Get UFO enable (ethtool_value) */
#define ETHTOOL_SUFO            0x00000022 /* Set UFO enable (ethtool_value) */
#define ETHTOOL_GGSO            0x00000023 /* Get GSO enable (ethtool_value) */
#define ETHTOOL_SGSO            0x00000024 /* Set GSO enable (ethtool_value) */
#define ETHTOOL_GFLAGS          0x00000025 /* Get flags bitmap(ethtool_value) */
#define ETHTOOL_SFLAGS          0x00000026 /* Set flags bitmap(ethtool_value) */
#define ETHTOOL_GPFLAGS         0x00000027 /* Get driver-private flags bitmap */
#define ETHTOOL_SPFLAGS         0x00000028 /* Set driver-private flags bitmap */

#define ETHTOOL_GRXFH           0x00000029 /* Get RX flow hash configuration */
#define ETHTOOL_SRXFH           0x0000002a /* Set RX flow hash configuration */
#define ETHTOOL_GGRO            0x0000002b /* Get GRO enable (ethtool_value) */
#define ETHTOOL_SGRO            0x0000002c /* Set GRO enable (ethtool_value) */
#define ETHTOOL_GRXRINGS        0x0000002d /* Get RX rings available for LB */
#define ETHTOOL_GRXCLSRLCNT     0x0000002e /* Get RX class rule count */
#define ETHTOOL_GRXCLSRULE      0x0000002f /* Get RX classification rule */
#define ETHTOOL_GRXCLSRLALL     0x00000030 /* Get all RX classification rule */
#define ETHTOOL_SRXCLSRLDEL     0x00000031 /* Delete RX classification rule */
#define ETHTOOL_SRXCLSRLINS     0x00000032 /* Insert RX classification rule */
#define ETHTOOL_FLASHDEV        0x00000033 /* Flash firmware to device */
#define ETHTOOL_RESET           0x00000034 /* Reset hardware */
#define ETHTOOL_SRXNTUPLE       0x00000035 /* Add an n-tuple filter to device */
#define ETHTOOL_GRXNTUPLE       0x00000036 /* deprecated */
#define ETHTOOL_GSSET_INFO      0x00000037 /* Get string set info */
#define ETHTOOL_GRXFHINDIR      0x00000038 /* Get RX flow hash indir'n table */
#define ETHTOOL_SRXFHINDIR      0x00000039 /* Set RX flow hash indir'n table */

#define ETHTOOL_GFEATURES       0x0000003a /* Get device offload settings */
#define ETHTOOL_SFEATURES       0x0000003b /* Change device offload settings */
#define ETHTOOL_GCHANNELS       0x0000003c /* Get no of channels */
#define ETHTOOL_SCHANNELS       0x0000003d /* Set no of channels */
#define ETHTOOL_SET_DUMP        0x0000003e /* Set dump settings */
#define ETHTOOL_GET_DUMP_FLAG   0x0000003f /* Get dump settings */
#define ETHTOOL_GET_DUMP_DATA   0x00000040 /* Get dump data */

/* compatibility with older code */
#define SPARC_ETH_GSET          ETHTOOL_GSET
#define SPARC_ETH_SSET          ETHTOOL_SSET

/* Indicates what features are supported by the interface. */
#define SUPPORTED_10baseT_Half          (1 << 0)
#define SUPPORTED_10baseT_Full          (1 << 1)
#define SUPPORTED_100baseT_Half         (1 << 2)
#define SUPPORTED_100baseT_Full         (1 << 3)
#define SUPPORTED_1000baseT_Half        (1 << 4)
#define SUPPORTED_1000baseT_Full        (1 << 5)
#define SUPPORTED_Autoneg               (1 << 6)
#define SUPPORTED_TP                    (1 << 7)
#define SUPPORTED_AUI                   (1 << 8)
#define SUPPORTED_MII                   (1 << 9)
#define SUPPORTED_FIBRE                 (1 << 10)
#define SUPPORTED_BNC                   (1 << 11)
#define SUPPORTED_10000baseT_Full       (1 << 12)
#define SUPPORTED_Pause                 (1 << 13)
#define SUPPORTED_Asym_Pause            (1 << 14)
#define SUPPORTED_2500baseX_Full        (1 << 15)
#define SUPPORTED_Backplane             (1 << 16)
#define SUPPORTED_1000baseKX_Full       (1 << 17)
#define SUPPORTED_10000baseKX4_Full     (1 << 18)
#define SUPPORTED_10000baseKR_Full      (1 << 19)
#define SUPPORTED_10000baseR_FEC        (1 << 20)
#define SUPPORTED_20000baseMLD2_Full    (1 << 21)
#define SUPPORTED_20000baseKR2_Full     (1 << 22)

/* Indicates what features are advertised by the interface. */
#define ADVERTISED_10baseT_Half         (1 << 0)
#define ADVERTISED_10baseT_Full         (1 << 1)
#define ADVERTISED_100baseT_Half        (1 << 2)
#define ADVERTISED_100baseT_Full        (1 << 3)
#define ADVERTISED_1000baseT_Half       (1 << 4)
#define ADVERTISED_1000baseT_Full       (1 << 5)
#define ADVERTISED_Autoneg              (1 << 6)
#define ADVERTISED_TP                   (1 << 7)
#define ADVERTISED_AUI                  (1 << 8)
#define ADVERTISED_MII                  (1 << 9)
#define ADVERTISED_FIBRE                (1 << 10)
#define ADVERTISED_BNC                  (1 << 11)
#define ADVERTISED_10000baseT_Full      (1 << 12)
#define ADVERTISED_Pause                (1 << 13)
#define ADVERTISED_Asym_Pause           (1 << 14)
#define ADVERTISED_2500baseX_Full       (1 << 15)
#define ADVERTISED_Backplane            (1 << 16)
#define ADVERTISED_1000baseKX_Full      (1 << 17)
#define ADVERTISED_10000baseKX4_Full    (1 << 18)
#define ADVERTISED_10000baseKR_Full     (1 << 19)
#define ADVERTISED_10000baseR_FEC       (1 << 20)
#define ADVERTISED_20000baseMLD2_Full   (1 << 21)
#define ADVERTISED_20000baseKR2_Full    (1 << 22)

/* The following are all involved in forcing a particular link
 * mode for the device for setting things.  When getting the
 * devices settings, these indicate the current mode and whether
 * it was forced up into this mode or autonegotiated.
 */

/* The forced speed, 10Mb, 100Mb, gigabit, 2.5Gb, 10GbE. */
#define SPEED_10                10
#define SPEED_100               100
#define SPEED_1000              1000
#define SPEED_2500              2500
#define SPEED_10000             10000

/* Duplex, half or full. */
#define DUPLEX_HALF             0x00
#define DUPLEX_FULL             0x01

/* Which connector port. */
#define PORT_TP                 0x00
#define PORT_AUI                0x01
#define PORT_MII                0x02
#define PORT_FIBRE              0x03
#define PORT_BNC                0x04
#define PORT_DA                 0x05
#define PORT_NONE               0xef
#define PORT_OTHER              0xff

/* Which transceiver to use. */
#define XCVR_INTERNAL           0x00
#define XCVR_EXTERNAL           0x01
#define XCVR_DUMMY1             0x02
#define XCVR_DUMMY2             0x03
#define XCVR_DUMMY3             0x04

/* Enable or disable autonegotiation.  If this is set to enable,
 * the forced link modes above are completely ignored.
 */
#define AUTONEG_DISABLE         0x00
#define AUTONEG_ENABLE          0x01

/* Mode MDI or MDI-X */
#define ETH_TP_MDI_INVALID      0x00
#define ETH_TP_MDI              0x01
#define ETH_TP_MDI_X            0x02

/* Wake-On-Lan options. */
#define WAKE_PHY                (1 << 0)
#define WAKE_UCAST              (1 << 1)
#define WAKE_MCAST              (1 << 2)
#define WAKE_BCAST              (1 << 3)
#define WAKE_ARP                (1 << 4)
#define WAKE_MAGIC              (1 << 5)
#define WAKE_MAGICSECURE        (1 << 6) /* only meaningful if WAKE_MAGIC */

/* L2-L4 network traffic flow types */
#define TCP_V4_FLOW     0x01    /* hash or spec (tcp_ip4_spec) */
#define UDP_V4_FLOW     0x02    /* hash or spec (udp_ip4_spec) */
#define SCTP_V4_FLOW    0x03    /* hash or spec (sctp_ip4_spec) */
#define AH_ESP_V4_FLOW  0x04    /* hash only */
#define TCP_V6_FLOW     0x05    /* hash only */
#define UDP_V6_FLOW     0x06    /* hash only */
#define SCTP_V6_FLOW    0x07    /* hash only */
#define AH_ESP_V6_FLOW  0x08    /* hash only */
#define AH_V4_FLOW      0x09    /* hash or spec (ah_ip4_spec) */
#define ESP_V4_FLOW     0x0a    /* hash or spec (esp_ip4_spec) */
#define AH_V6_FLOW      0x0b    /* hash only */
#define ESP_V6_FLOW     0x0c    /* hash only */
#define IP_USER_FLOW    0x0d    /* spec only (usr_ip4_spec) */
#define IPV4_FLOW       0x10    /* hash only */
#define IPV6_FLOW       0x11    /* hash only */
#define ETHER_FLOW      0x12    /* spec only (ether_spec) */
/* Flag to enable additional fields in struct ethtool_rx_flow_spec */
#define FLOW_EXT        0x80000000

/* L3-L4 network traffic flow hash options */
#define RXH_L2DA        (1 << 1)
#define RXH_VLAN        (1 << 2)
#define RXH_L3_PROTO    (1 << 3)
#define RXH_IP_SRC      (1 << 4)
#define RXH_IP_DST      (1 << 5)
#define RXH_L4_B_0_1    (1 << 6) /* src port in case of TCP/UDP/SCTP */
#define RXH_L4_B_2_3    (1 << 7) /* dst port in case of TCP/UDP/SCTP */
#define RXH_DISCARD     (1 << 31)

#define RX_CLS_FLOW_DISC        0xffffffffffffffffULL

/* Reset flags */
/* The reset() operation must clear the flags for the components which
 * were actually reset.  On successful return, the flags indicate the
 * components which were not reset, either because they do not exist
 * in the hardware or because they cannot be reset independently.  The
 * driver must never reset any components that were not requested.
 */
enum ethtool_reset_flags {
        /* These flags represent components dedicated to the interface
         * the command is addressed to.  Shift any flag left by
         * ETH_RESET_SHARED_SHIFT to reset a shared component of the
         * same type.
         */
        ETH_RESET_MGMT          = 1 << 0,       /* Management processor */
        ETH_RESET_IRQ           = 1 << 1,       /* Interrupt requester */
        ETH_RESET_DMA           = 1 << 2,       /* DMA engine */
        ETH_RESET_FILTER        = 1 << 3,       /* Filtering/flow direction */
        ETH_RESET_OFFLOAD       = 1 << 4,       /* Protocol offload */
        ETH_RESET_MAC           = 1 << 5,       /* Media access controller */
        ETH_RESET_PHY           = 1 << 6,       /* Transceiver/PHY */
        ETH_RESET_RAM           = 1 << 7,       /* RAM shared between
                                                 * multiple components */

        ETH_RESET_DEDICATED     = 0x0000ffff,   /* All components dedicated to
                                                 * this interface */
        ETH_RESET_ALL           = 0xffffffff,   /* All components used by this
                                                 * interface, even if shared */
};
#define ETH_RESET_SHARED_SHIFT  16

#endif /* _LINUX_ETHTOOL_H */