00db8189d9
ethernet drivers to remain as ignorant as is reasonable of the connected PHY's design and operation details. Signed-off-by: Andy Fleming <afleming@freescale.com> Signed-off-by: Jeff Garzik <jgarzik@pobox.com>
476 lines
16 KiB
C
476 lines
16 KiB
C
/*
|
|
* 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)
|
|
*/
|
|
|
|
#ifndef _LINUX_ETHTOOL_H
|
|
#define _LINUX_ETHTOOL_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, 10Mb, 100Mb, gigabit */
|
|
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 */
|
|
u32 maxtxpkt; /* Tx pkts before generating tx int */
|
|
u32 maxrxpkt; /* Rx pkts before generating rx int */
|
|
u32 reserved[4];
|
|
};
|
|
|
|
#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[32]; /* firmware version string, if applicable */
|
|
char bus_info[ETHTOOL_BUSINFO_LEN]; /* Bus info for this IF. */
|
|
/* For PCI devices, use pci_name(pci_dev). */
|
|
char reserved1[32];
|
|
char reserved2[16];
|
|
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];
|
|
};
|
|
|
|
/* for configuring coalescing parameters of chip */
|
|
struct ethtool_coalesce {
|
|
u32 cmd; /* ETHTOOL_{G,S}COALESCE */
|
|
|
|
/* How many usecs to delay an RX interrupt after
|
|
* a packet arrives. If 0, only rx_max_coalesced_frames
|
|
* is used.
|
|
*/
|
|
u32 rx_coalesce_usecs;
|
|
|
|
/* How many packets to delay an RX interrupt after
|
|
* a packet arrives. If 0, only rx_coalesce_usecs is
|
|
* used. It is illegal to set both usecs and max frames
|
|
* to zero as this would cause RX interrupts to never be
|
|
* generated.
|
|
*/
|
|
u32 rx_max_coalesced_frames;
|
|
|
|
/* Same as above two parameters, except that these values
|
|
* apply while an IRQ is being serviced by the host. Not
|
|
* all cards support this feature and the values are ignored
|
|
* in that case.
|
|
*/
|
|
u32 rx_coalesce_usecs_irq;
|
|
u32 rx_max_coalesced_frames_irq;
|
|
|
|
/* How many usecs to delay a TX interrupt after
|
|
* a packet is sent. If 0, only tx_max_coalesced_frames
|
|
* is used.
|
|
*/
|
|
u32 tx_coalesce_usecs;
|
|
|
|
/* How many packets to delay a TX interrupt after
|
|
* a packet is sent. If 0, only tx_coalesce_usecs is
|
|
* used. It is illegal to set both usecs and max frames
|
|
* to zero as this would cause TX interrupts to never be
|
|
* generated.
|
|
*/
|
|
u32 tx_max_coalesced_frames;
|
|
|
|
/* Same as above two parameters, except that these values
|
|
* apply while an IRQ is being serviced by the host. Not
|
|
* all cards support this feature and the values are ignored
|
|
* in that case.
|
|
*/
|
|
u32 tx_coalesce_usecs_irq;
|
|
u32 tx_max_coalesced_frames_irq;
|
|
|
|
/* 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.
|
|
*/
|
|
u32 stats_block_coalesce_usecs;
|
|
|
|
/* 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.
|
|
*/
|
|
u32 use_adaptive_rx_coalesce;
|
|
u32 use_adaptive_tx_coalesce;
|
|
|
|
/* When the packet rate (measured in packets per second)
|
|
* is below pkt_rate_low, the {rx,tx}_*_low parameters are
|
|
* used.
|
|
*/
|
|
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;
|
|
|
|
/* 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.
|
|
*/
|
|
|
|
/* When the packet rate is (measured in packets per second)
|
|
* is above pkt_rate_high, the {rx,tx}_*_high parameters are
|
|
* used.
|
|
*/
|
|
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;
|
|
|
|
/* How often to do adaptive coalescing packet rate sampling,
|
|
* measured in seconds. Must not be zero.
|
|
*/
|
|
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;
|
|
};
|
|
|
|
/* 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 'autonet' 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,
|
|
};
|
|
|
|
/* 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];
|
|
};
|
|
|
|
enum ethtool_test_flags {
|
|
ETH_TEST_FL_OFFLINE = (1 << 0), /* online / offline */
|
|
ETH_TEST_FL_FAILED = (1 << 1), /* test passed / failed */
|
|
};
|
|
|
|
/* 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 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);
|
|
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);
|
|
|
|
/**
|
|
* ðtool_ops - Alter and report network device settings
|
|
* get_settings: Get device-specific settings
|
|
* set_settings: Set device-specific settings
|
|
* get_drvinfo: Report driver information
|
|
* get_regs: Get device registers
|
|
* get_wol: Report whether Wake-on-Lan is enabled
|
|
* set_wol: Turn Wake-on-Lan on or off
|
|
* get_msglevel: Report driver message level
|
|
* set_msglevel: Set driver message level
|
|
* nway_reset: Restart autonegotiation
|
|
* get_link: Get link status
|
|
* get_eeprom: Read data from the device EEPROM
|
|
* set_eeprom: Write data to the device EEPROM
|
|
* get_coalesce: Get interrupt coalescing parameters
|
|
* set_coalesce: Set interrupt coalescing parameters
|
|
* get_ringparam: Report ring sizes
|
|
* set_ringparam: Set ring sizes
|
|
* get_pauseparam: Report pause parameters
|
|
* set_pauseparam: Set pause paramters
|
|
* get_rx_csum: Report whether receive checksums are turned on or off
|
|
* set_rx_csum: Turn receive checksum on or off
|
|
* get_tx_csum: Report whether transmit checksums are turned on or off
|
|
* set_tx_csum: Turn transmit checksums on or off
|
|
* get_sg: Report whether scatter-gather is enabled
|
|
* set_sg: Turn scatter-gather on or off
|
|
* get_tso: Report whether TCP segmentation offload is enabled
|
|
* set_tso: Turn TCP segmentation offload on or off
|
|
* self_test: Run specified self-tests
|
|
* get_strings: Return a set of strings that describe the requested objects
|
|
* phys_id: Identify the device
|
|
* get_stats: Return statistics about the device
|
|
*
|
|
* Description:
|
|
*
|
|
* get_settings:
|
|
* @get_settings is passed an ðtool_cmd to fill in. It returns
|
|
* an negative errno or zero.
|
|
*
|
|
* set_settings:
|
|
* @set_settings is passed an ðtool_cmd and should attempt to set
|
|
* all the settings this device supports. It may return an error value
|
|
* if something goes wrong (otherwise 0).
|
|
*
|
|
* get_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:
|
|
* 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.
|
|
*/
|
|
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);
|
|
int (*self_test_count)(struct net_device *);
|
|
void (*self_test)(struct net_device *, struct ethtool_test *, u64 *);
|
|
void (*get_strings)(struct net_device *, u32 stringset, u8 *);
|
|
int (*phys_id)(struct net_device *, u32);
|
|
int (*get_stats_count)(struct net_device *);
|
|
void (*get_ethtool_stats)(struct net_device *, struct ethtool_stats *, u64 *);
|
|
int (*begin)(struct net_device *);
|
|
void (*complete)(struct net_device *);
|
|
};
|
|
|
|
/* 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. */
|
|
#define ETHTOOL_GLINK 0x0000000a /* Get link status (ethtool_value) */
|
|
#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) */
|
|
|
|
/* 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)
|
|
|
|
/* 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)
|
|
|
|
/* 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 foced up into this mode or autonegotiated.
|
|
*/
|
|
|
|
/* The forced speed, 10Mb, 100Mb, gigabit, 10GbE. */
|
|
#define SPEED_10 10
|
|
#define SPEED_100 100
|
|
#define SPEED_1000 1000
|
|
#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
|
|
|
|
/* 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
|
|
|
|
/* 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 */
|
|
|
|
#endif /* _LINUX_ETHTOOL_H */
|