include/linux/ethtool.h

   1 /*
   2  * ethtool.h: Defines for Linux ethtool.
   3  *
   4  * Copyright (C) 1998 David S. Miller (davem@redhat.com)
   5  * Copyright 2001 Jeff Garzik <jgarzik@pobox.com>
   6  * Portions Copyright 2001 Sun Microsystems (thockin@sun.com)
   7  * Portions Copyright 2002 Intel (eli.kupermann@intel.com,
   8  *                                christopher.leech@intel.com,
   9  *                                scott.feldman@intel.com)
  10  */
  11
  12 #ifndef _LINUX_ETHTOOL_H
  13 #define _LINUX_ETHTOOL_H
  14
  15
  16 /* This should work for both 32 and 64 bit userland. */
  17 struct ethtool_cmd {
  18         u32     cmd;
  19         u32     supported;      /* Features this interface supports */
  20         u32     advertising;    /* Features this interface advertises */
  21         u16     speed;          /* The forced speed, 10Mb, 100Mb, gigabit */
  22         u8      duplex;         /* Duplex, half or full */
  23         u8      port;           /* Which connector port */
  24         u8      phy_address;
  25         u8      transceiver;    /* Which transceiver to use */
  26         u8      autoneg;        /* Enable or disable autonegotiation */
  27         u32     maxtxpkt;       /* Tx pkts before generating tx int */
  28         u32     maxrxpkt;       /* Rx pkts before generating rx int */
  29         u32     reserved[4];
  30 };
  31
  32 #define ETHTOOL_BUSINFO_LEN     32
  33 /* these strings are set to whatever the driver author decides... */
  34 struct ethtool_drvinfo {
  35         u32     cmd;
  36         char    driver[32];     /* driver short name, "tulip", "eepro100" */
  37         char    version[32];    /* driver version string */
  38         char    fw_version[32]; /* firmware version string, if applicable */
  39         char    bus_info[ETHTOOL_BUSINFO_LEN];  /* Bus info for this IF. */
  40                                 /* For PCI devices, use pci_name(pci_dev). */
  41         char    reserved1[32];
  42         char    reserved2[16];
  43         u32     n_stats;        /* number of u64's from ETHTOOL_GSTATS */
  44         u32     testinfo_len;
  45         u32     eedump_len;     /* Size of data from ETHTOOL_GEEPROM (bytes) */
  46         u32     regdump_len;    /* Size of data from ETHTOOL_GREGS (bytes) */
  47 };
  48
  49 #define SOPASS_MAX      6
  50 /* wake-on-lan settings */
  51 struct ethtool_wolinfo {
  52         u32     cmd;
  53         u32     supported;
  54         u32     wolopts;
  55         u8      sopass[SOPASS_MAX]; /* SecureOn(tm) password */
  56 };
  57
  58 /* for passing single values */
  59 struct ethtool_value {
  60         u32     cmd;
  61         u32     data;
  62 };
  63
  64 /* for passing big chunks of data */
  65 struct ethtool_regs {
  66         u32     cmd;
  67         u32     version; /* driver-specific, indicates different chips/revs */
  68         u32     len; /* bytes */
  69         u8      data[0];
  70 };
  71
  72 /* for passing EEPROM chunks */
  73 struct ethtool_eeprom {
  74         u32     cmd;
  75         u32     magic;
  76         u32     offset; /* in bytes */
  77         u32     len; /* in bytes */
  78         u8      data[0];
  79 };
  80
  81 /* for configuring coalescing parameters of chip */
  82 struct ethtool_coalesce {
  83         u32     cmd;    /* ETHTOOL_{G,S}COALESCE */
  84
  85         /* How many usecs to delay an RX interrupt after
  86          * a packet arrives.  If 0, only rx_max_coalesced_frames
  87          * is used.
  88          */
  89         u32     rx_coalesce_usecs;
  90
  91         /* How many packets to delay an RX interrupt after
  92          * a packet arrives.  If 0, only rx_coalesce_usecs is
  93          * used.  It is illegal to set both usecs and max frames
  94          * to zero as this would cause RX interrupts to never be
  95          * generated.
  96          */
  97         u32     rx_max_coalesced_frames;
  98
  99         /* Same as above two parameters, except that these values
 100          * apply while an IRQ is being serviced by the host.  Not
 101          * all cards support this feature and the values are ignored
 102          * in that case.
 103          */
 104         u32     rx_coalesce_usecs_irq;
 105         u32     rx_max_coalesced_frames_irq;
 106
 107         /* How many usecs to delay a TX interrupt after
 108          * a packet is sent.  If 0, only tx_max_coalesced_frames
 109          * is used.
 110          */
 111         u32     tx_coalesce_usecs;
 112
 113         /* How many packets to delay a TX interrupt after
 114          * a packet is sent.  If 0, only tx_coalesce_usecs is
 115          * used.  It is illegal to set both usecs and max frames
 116          * to zero as this would cause TX interrupts to never be
 117          * generated.
 118          */
 119         u32     tx_max_coalesced_frames;
 120
 121         /* Same as above two parameters, except that these values
 122          * apply while an IRQ is being serviced by the host.  Not
 123          * all cards support this feature and the values are ignored
 124          * in that case.
 125          */
 126         u32     tx_coalesce_usecs_irq;
 127         u32     tx_max_coalesced_frames_irq;
 128
 129         /* How many usecs to delay in-memory statistics
 130          * block updates.  Some drivers do not have an in-memory
 131          * statistic block, and in such cases this value is ignored.
 132          * This value must not be zero.
 133          */
 134         u32     stats_block_coalesce_usecs;
 135
 136         /* Adaptive RX/TX coalescing is an algorithm implemented by
 137          * some drivers to improve latency under low packet rates and
 138          * improve throughput under high packet rates.  Some drivers
 139          * only implement one of RX or TX adaptive coalescing.  Anything
 140          * not implemented by the driver causes these values to be
 141          * silently ignored.
 142          */
 143         u32     use_adaptive_rx_coalesce;
 144         u32     use_adaptive_tx_coalesce;
 145
 146         /* When the packet rate (measured in packets per second)
 147          * is below pkt_rate_low, the {rx,tx}_*_low parameters are
 148          * used.
 149          */
 150         u32     pkt_rate_low;
 151         u32     rx_coalesce_usecs_low;
 152         u32     rx_max_coalesced_frames_low;
 153         u32     tx_coalesce_usecs_low;
 154         u32     tx_max_coalesced_frames_low;
 155
 156         /* When the packet rate is below pkt_rate_high but above
 157          * pkt_rate_low (both measured in packets per second) the
 158          * normal {rx,tx}_* coalescing parameters are used.
 159          */
 160
 161         /* When the packet rate is (measured in packets per second)
 162          * is above pkt_rate_high, the {rx,tx}_*_high parameters are
 163          * used.
 164          */
 165         u32     pkt_rate_high;
 166         u32     rx_coalesce_usecs_high;
 167         u32     rx_max_coalesced_frames_high;
 168         u32     tx_coalesce_usecs_high;
 169         u32     tx_max_coalesced_frames_high;
 170
 171         /* How often to do adaptive coalescing packet rate sampling,
 172          * measured in seconds.  Must not be zero.
 173          */
 174         u32     rate_sample_interval;
 175 };
 176
 177 /* for configuring RX/TX ring parameters */
 178 struct ethtool_ringparam {
 179         u32     cmd;    /* ETHTOOL_{G,S}RINGPARAM */
 180
 181         /* Read only attributes.  These indicate the maximum number
 182          * of pending RX/TX ring entries the driver will allow the
 183          * user to set.
 184          */
 185         u32     rx_max_pending;
 186         u32     rx_mini_max_pending;
 187         u32     rx_jumbo_max_pending;
 188         u32     tx_max_pending;
 189
 190         /* Values changeable by the user.  The valid values are
 191          * in the range 1 to the "*_max_pending" counterpart above.
 192          */
 193         u32     rx_pending;
 194         u32     rx_mini_pending;
 195         u32     rx_jumbo_pending;
 196         u32     tx_pending;
 197 };
 198
 199 /* for configuring link flow control parameters */
 200 struct ethtool_pauseparam {
 201         u32     cmd;    /* ETHTOOL_{G,S}PAUSEPARAM */
 202
 203         /* If the link is being auto-negotiated (via ethtool_cmd.autoneg
 204          * being true) the user may set 'autonet' here non-zero to have the
 205          * pause parameters be auto-negotiated too.  In such a case, the
 206          * {rx,tx}_pause values below determine what capabilities are
 207          * advertised.
 208          *
 209          * If 'autoneg' is zero or the link is not being auto-negotiated,
 210          * then {rx,tx}_pause force the driver to use/not-use pause
 211          * flow control.
 212          */
 213         u32     autoneg;
 214         u32     rx_pause;
 215         u32     tx_pause;
 216 };
 217
 218 #define ETH_GSTRING_LEN         32
 219 enum ethtool_stringset {
 220         ETH_SS_TEST             = 0,
 221         ETH_SS_STATS,
 222 };
 223
 224 /* for passing string sets for data tagging */
 225 struct ethtool_gstrings {
 226         u32     cmd;            /* ETHTOOL_GSTRINGS */
 227         u32     string_set;     /* string set id e.c. ETH_SS_TEST, etc*/
 228         u32     len;            /* number of strings in the string set */
 229         u8      data[0];
 230 };
 231
 232 enum ethtool_test_flags {
 233         ETH_TEST_FL_OFFLINE     = (1 << 0),     /* online / offline */
 234         ETH_TEST_FL_FAILED      = (1 << 1),     /* test passed / failed */
 235 };
 236
 237 /* for requesting NIC test and getting results*/
 238 struct ethtool_test {
 239         u32     cmd;            /* ETHTOOL_TEST */
 240         u32     flags;          /* ETH_TEST_FL_xxx */
 241         u32     reserved;
 242         u32     len;            /* result length, in number of u64 elements */
 243         u64     data[0];
 244 };
 245
 246 /* for dumping NIC-specific statistics */
 247 struct ethtool_stats {
 248         u32     cmd;            /* ETHTOOL_GSTATS */
 249         u32     n_stats;        /* number of u64's being returned */
 250         u64     data[0];
 251 };
 252
 253 struct ethtool_perm_addr {
 254         u32     cmd;            /* ETHTOOL_GPERMADDR */
 255         u32     size;
 256         u8      data[0];
 257 };
 258
 259 struct net_device;
 260
 261 /* Some generic methods drivers may use in their ethtool_ops */
 262 u32 ethtool_op_get_link(struct net_device *dev);
 263 u32 ethtool_op_get_tx_csum(struct net_device *dev);
 264 int ethtool_op_set_tx_csum(struct net_device *dev, u32 data);
 265 int ethtool_op_set_tx_hw_csum(struct net_device *dev, u32 data);
 266 u32 ethtool_op_get_sg(struct net_device *dev);
 267 int ethtool_op_set_sg(struct net_device *dev, u32 data);
 268 u32 ethtool_op_get_tso(struct net_device *dev);
 269 int ethtool_op_set_tso(struct net_device *dev, u32 data);
 270 int ethtool_op_get_perm_addr(struct net_device *dev,
 271                              struct ethtool_perm_addr *addr, u8 *data);
 272
 273 /**
 274  * &ethtool_ops - Alter and report network device settings
 275  * get_settings: Get device-specific settings
 276  * set_settings: Set device-specific settings
 277  * get_drvinfo: Report driver information
 278  * get_regs: Get device registers
 279  * get_wol: Report whether Wake-on-Lan is enabled
 280  * set_wol: Turn Wake-on-Lan on or off
 281  * get_msglevel: Report driver message level
 282  * set_msglevel: Set driver message level
 283  * nway_reset: Restart autonegotiation
 284  * get_link: Get link status
 285  * get_eeprom: Read data from the device EEPROM
 286  * set_eeprom: Write data to the device EEPROM
 287  * get_coalesce: Get interrupt coalescing parameters
 288  * set_coalesce: Set interrupt coalescing parameters
 289  * get_ringparam: Report ring sizes
 290  * set_ringparam: Set ring sizes
 291  * get_pauseparam: Report pause parameters
 292  * set_pauseparam: Set pause paramters
 293  * get_rx_csum: Report whether receive checksums are turned on or off
 294  * set_rx_csum: Turn receive checksum on or off
 295  * get_tx_csum: Report whether transmit checksums are turned on or off
 296  * set_tx_csum: Turn transmit checksums on or off
 297  * get_sg: Report whether scatter-gather is enabled
 298  * set_sg: Turn scatter-gather on or off
 299  * get_tso: Report whether TCP segmentation offload is enabled
 300  * set_tso: Turn TCP segmentation offload on or off
 301  * self_test: Run specified self-tests
 302  * get_strings: Return a set of strings that describe the requested objects
 303  * phys_id: Identify the device
 304  * get_stats: Return statistics about the device
 305  * get_perm_addr: Gets the permanent hardware address
 306  *
 307  * Description:
 308  *
 309  * get_settings:
 310  *      @get_settings is passed an &ethtool_cmd to fill in.  It returns
 311  *      an negative errno or zero.
 312  *
 313  * set_settings:
 314  *      @set_settings is passed an &ethtool_cmd and should attempt to set
 315  *      all the settings this device supports.  It may return an error value
 316  *      if something goes wrong (otherwise 0).
 317  *
 318  * get_eeprom:
 319  *      Should fill in the magic field.  Don't need to check len for zero
 320  *      or wraparound.  Fill in the data argument with the eeprom values
 321  *      from offset to offset + len.  Update len to the amount read.
 322  *      Returns an error or zero.
 323  *
 324  * set_eeprom:
 325  *      Should validate the magic field.  Don't need to check len for zero
 326  *      or wraparound.  Update len to the amount written.  Returns an error
 327  *      or zero.
 328  */
 329 struct ethtool_ops {
 330         int     (*get_settings)(struct net_device *, struct ethtool_cmd *);
 331         int     (*set_settings)(struct net_device *, struct ethtool_cmd *);
 332         void    (*get_drvinfo)(struct net_device *, struct ethtool_drvinfo *);
 333         int     (*get_regs_len)(struct net_device *);
 334         void    (*get_regs)(struct net_device *, struct ethtool_regs *, void *);
 335         void    (*get_wol)(struct net_device *, struct ethtool_wolinfo *);
 336         int     (*set_wol)(struct net_device *, struct ethtool_wolinfo *);
 337         u32     (*get_msglevel)(struct net_device *);
 338         void    (*set_msglevel)(struct net_device *, u32);
 339         int     (*nway_reset)(struct net_device *);
 340         u32     (*get_link)(struct net_device *);
 341         int     (*get_eeprom_len)(struct net_device *);
 342         int     (*get_eeprom)(struct net_device *, struct ethtool_eeprom *, u8 *);
 343         int     (*set_eeprom)(struct net_device *, struct ethtool_eeprom *, u8 *);
 344         int     (*get_coalesce)(struct net_device *, struct ethtool_coalesce *);
 345         int     (*set_coalesce)(struct net_device *, struct ethtool_coalesce *);
 346         void    (*get_ringparam)(struct net_device *, struct ethtool_ringparam *);
 347         int     (*set_ringparam)(struct net_device *, struct ethtool_ringparam *);
 348         void    (*get_pauseparam)(struct net_device *, struct ethtool_pauseparam*);
 349         int     (*set_pauseparam)(struct net_device *, struct ethtool_pauseparam*);
 350         u32     (*get_rx_csum)(struct net_device *);
 351         int     (*set_rx_csum)(struct net_device *, u32);
 352         u32     (*get_tx_csum)(struct net_device *);
 353         int     (*set_tx_csum)(struct net_device *, u32);
 354         u32     (*get_sg)(struct net_device *);
 355         int     (*set_sg)(struct net_device *, u32);
 356         u32     (*get_tso)(struct net_device *);
 357         int     (*set_tso)(struct net_device *, u32);
 358         int     (*self_test_count)(struct net_device *);
 359         void    (*self_test)(struct net_device *, struct ethtool_test *, u64 *);
 360         void    (*get_strings)(struct net_device *, u32 stringset, u8 *);
 361         int     (*phys_id)(struct net_device *, u32);
 362         int     (*get_stats_count)(struct net_device *);
 363         void    (*get_ethtool_stats)(struct net_device *, struct ethtool_stats *, u64 *);
 364         int     (*get_perm_addr)(struct net_device *, struct ethtool_perm_addr *, u8 *);
 365         int     (*begin)(struct net_device *);
 366         void    (*complete)(struct net_device *);
 367 };
 368
 369 /* CMDs currently supported */
 370 #define ETHTOOL_GSET            0x00000001 /* Get settings. */
 371 #define ETHTOOL_SSET            0x00000002 /* Set settings. */
 372 #define ETHTOOL_GDRVINFO        0x00000003 /* Get driver info. */
 373 #define ETHTOOL_GREGS           0x00000004 /* Get NIC registers. */
 374 #define ETHTOOL_GWOL            0x00000005 /* Get wake-on-lan options. */
 375 #define ETHTOOL_SWOL            0x00000006 /* Set wake-on-lan options. */
 376 #define ETHTOOL_GMSGLVL         0x00000007 /* Get driver message level */
 377 #define ETHTOOL_SMSGLVL         0x00000008 /* Set driver msg level. */
 378 #define ETHTOOL_NWAY_RST        0x00000009 /* Restart autonegotiation. */
 379 #define ETHTOOL_GLINK           0x0000000a /* Get link status (ethtool_value) */
 380 #define ETHTOOL_GEEPROM         0x0000000b /* Get EEPROM data */
 381 #define ETHTOOL_SEEPROM         0x0000000c /* Set EEPROM data. */
 382 #define ETHTOOL_GCOALESCE       0x0000000e /* Get coalesce config */
 383 #define ETHTOOL_SCOALESCE       0x0000000f /* Set coalesce config. */
 384 #define ETHTOOL_GRINGPARAM      0x00000010 /* Get ring parameters */
 385 #define ETHTOOL_SRINGPARAM      0x00000011 /* Set ring parameters. */
 386 #define ETHTOOL_GPAUSEPARAM     0x00000012 /* Get pause parameters */
 387 #define ETHTOOL_SPAUSEPARAM     0x00000013 /* Set pause parameters. */
 388 #define ETHTOOL_GRXCSUM         0x00000014 /* Get RX hw csum enable (ethtool_value) */
 389 #define ETHTOOL_SRXCSUM         0x00000015 /* Set RX hw csum enable (ethtool_value) */
 390 #define ETHTOOL_GTXCSUM         0x00000016 /* Get TX hw csum enable (ethtool_value) */
 391 #define ETHTOOL_STXCSUM         0x00000017 /* Set TX hw csum enable (ethtool_value) */
 392 #define ETHTOOL_GSG             0x00000018 /* Get scatter-gather enable
 393                                             * (ethtool_value) */
 394 #define ETHTOOL_SSG             0x00000019 /* Set scatter-gather enable
 395                                             * (ethtool_value). */
 396 #define ETHTOOL_TEST            0x0000001a /* execute NIC self-test. */
 397 #define ETHTOOL_GSTRINGS        0x0000001b /* get specified string set */
 398 #define ETHTOOL_PHYS_ID         0x0000001c /* identify the NIC */
 399 #define ETHTOOL_GSTATS          0x0000001d /* get NIC-specific statistics */
 400 #define ETHTOOL_GTSO            0x0000001e /* Get TSO enable (ethtool_value) */
 401 #define ETHTOOL_STSO            0x0000001f /* Set TSO enable (ethtool_value) */
 402 #define ETHTOOL_GPERMADDR       0x00000020 /* Get permanent hardware address */
 403
 404 /* compatibility with older code */
 405 #define SPARC_ETH_GSET          ETHTOOL_GSET
 406 #define SPARC_ETH_SSET          ETHTOOL_SSET
 407
 408 /* Indicates what features are supported by the interface. */
 409 #define SUPPORTED_10baseT_Half          (1 << 0)
 410 #define SUPPORTED_10baseT_Full          (1 << 1)
 411 #define SUPPORTED_100baseT_Half         (1 << 2)
 412 #define SUPPORTED_100baseT_Full         (1 << 3)
 413 #define SUPPORTED_1000baseT_Half        (1 << 4)
 414 #define SUPPORTED_1000baseT_Full        (1 << 5)
 415 #define SUPPORTED_Autoneg               (1 << 6)
 416 #define SUPPORTED_TP                    (1 << 7)
 417 #define SUPPORTED_AUI                   (1 << 8)
 418 #define SUPPORTED_MII                   (1 << 9)
 419 #define SUPPORTED_FIBRE                 (1 << 10)
 420 #define SUPPORTED_BNC                   (1 << 11)
 421 #define SUPPORTED_10000baseT_Full       (1 << 12)
 422 #define SUPPORTED_Pause                 (1 << 13)
 423 #define SUPPORTED_Asym_Pause            (1 << 14)
 424
 425 /* Indicates what features are advertised by the interface. */
 426 #define ADVERTISED_10baseT_Half         (1 << 0)
 427 #define ADVERTISED_10baseT_Full         (1 << 1)
 428 #define ADVERTISED_100baseT_Half        (1 << 2)
 429 #define ADVERTISED_100baseT_Full        (1 << 3)
 430 #define ADVERTISED_1000baseT_Half       (1 << 4)
 431 #define ADVERTISED_1000baseT_Full       (1 << 5)
 432 #define ADVERTISED_Autoneg              (1 << 6)
 433 #define ADVERTISED_TP                   (1 << 7)
 434 #define ADVERTISED_AUI                  (1 << 8)
 435 #define ADVERTISED_MII                  (1 << 9)
 436 #define ADVERTISED_FIBRE                (1 << 10)
 437 #define ADVERTISED_BNC                  (1 << 11)
 438 #define ADVERTISED_10000baseT_Full      (1 << 12)
 439 #define ADVERTISED_Pause                (1 << 13)
 440 #define ADVERTISED_Asym_Pause           (1 << 14)
 441
 442 /* The following are all involved in forcing a particular link
 443  * mode for the device for setting things.  When getting the
 444  * devices settings, these indicate the current mode and whether
 445  * it was foced up into this mode or autonegotiated.
 446  */
 447
 448 /* The forced speed, 10Mb, 100Mb, gigabit, 10GbE. */
 449 #define SPEED_10                10
 450 #define SPEED_100               100
 451 #define SPEED_1000              1000
 452 #define SPEED_10000             10000
 453
 454 /* Duplex, half or full. */
 455 #define DUPLEX_HALF             0x00
 456 #define DUPLEX_FULL             0x01
 457
 458 /* Which connector port. */
 459 #define PORT_TP                 0x00
 460 #define PORT_AUI                0x01
 461 #define PORT_MII                0x02
 462 #define PORT_FIBRE              0x03
 463 #define PORT_BNC                0x04
 464
 465 /* Which transceiver to use. */
 466 #define XCVR_INTERNAL           0x00
 467 #define XCVR_EXTERNAL           0x01
 468 #define XCVR_DUMMY1             0x02
 469 #define XCVR_DUMMY2             0x03
 470 #define XCVR_DUMMY3             0x04
 471
 472 /* Enable or disable autonegotiation.  If this is set to enable,
 473  * the forced link modes above are completely ignored.
 474  */
 475 #define AUTONEG_DISABLE         0x00
 476 #define AUTONEG_ENABLE          0x01
 477
 478 /* Wake-On-Lan options. */
 479 #define WAKE_PHY                (1 << 0)
 480 #define WAKE_UCAST              (1 << 1)
 481 #define WAKE_MCAST              (1 << 2)
 482 #define WAKE_BCAST              (1 << 3)
 483 #define WAKE_ARP                (1 << 4)
 484 #define WAKE_MAGIC              (1 << 5)
 485 #define WAKE_MAGICSECURE        (1 << 6) /* only meaningful if WAKE_MAGIC */
 486
 487 #endif /* _LINUX_ETHTOOL_H */