blob: 93535f0932167818e5e7e9c168188cbed0626df9 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
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. */
17struct 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... */
34struct 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 */
51struct 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 */
59struct ethtool_value {
60 u32 cmd;
61 u32 data;
62};
63
64/* for passing big chunks of data */
65struct 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 */
73struct 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 */
82struct 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 */
178struct 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 */
200struct 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
219enum ethtool_stringset {
220 ETH_SS_TEST = 0,
221 ETH_SS_STATS,
222};
223
224/* for passing string sets for data tagging */
225struct 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
232enum 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*/
238struct 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 */
247struct ethtool_stats {
248 u32 cmd; /* ETHTOOL_GSTATS */
249 u32 n_stats; /* number of u64's being returned */
250 u64 data[0];
251};
252
Jon Wetzela6f9a702005-08-20 17:15:54 -0700253struct ethtool_perm_addr {
254 u32 cmd; /* ETHTOOL_GPERMADDR */
255 u32 size;
256 u8 data[0];
257};
258
Linus Torvalds1da177e2005-04-16 15:20:36 -0700259struct net_device;
260
261/* Some generic methods drivers may use in their ethtool_ops */
262u32 ethtool_op_get_link(struct net_device *dev);
263u32 ethtool_op_get_tx_csum(struct net_device *dev);
264int ethtool_op_set_tx_csum(struct net_device *dev, u32 data);
Jon Mason69f6a0f2005-05-29 20:27:24 -0700265int ethtool_op_set_tx_hw_csum(struct net_device *dev, u32 data);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700266u32 ethtool_op_get_sg(struct net_device *dev);
267int ethtool_op_set_sg(struct net_device *dev, u32 data);
268u32 ethtool_op_get_tso(struct net_device *dev);
269int ethtool_op_set_tso(struct net_device *dev, u32 data);
Jon Wetzela6f9a702005-08-20 17:15:54 -0700270int ethtool_op_get_perm_addr(struct net_device *dev,
271 struct ethtool_perm_addr *addr, u8 *data);
Ananda Rajue89e9cf2005-10-18 15:46:41 -0700272u32 ethtool_op_get_ufo(struct net_device *dev);
273int ethtool_op_set_ufo(struct net_device *dev, u32 data);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700274
275/**
276 * &ethtool_ops - Alter and report network device settings
277 * get_settings: Get device-specific settings
278 * set_settings: Set device-specific settings
279 * get_drvinfo: Report driver information
280 * get_regs: Get device registers
281 * get_wol: Report whether Wake-on-Lan is enabled
282 * set_wol: Turn Wake-on-Lan on or off
283 * get_msglevel: Report driver message level
284 * set_msglevel: Set driver message level
285 * nway_reset: Restart autonegotiation
286 * get_link: Get link status
287 * get_eeprom: Read data from the device EEPROM
288 * set_eeprom: Write data to the device EEPROM
289 * get_coalesce: Get interrupt coalescing parameters
290 * set_coalesce: Set interrupt coalescing parameters
291 * get_ringparam: Report ring sizes
292 * set_ringparam: Set ring sizes
293 * get_pauseparam: Report pause parameters
294 * set_pauseparam: Set pause paramters
295 * get_rx_csum: Report whether receive checksums are turned on or off
296 * set_rx_csum: Turn receive checksum on or off
297 * get_tx_csum: Report whether transmit checksums are turned on or off
298 * set_tx_csum: Turn transmit checksums on or off
299 * get_sg: Report whether scatter-gather is enabled
300 * set_sg: Turn scatter-gather on or off
301 * get_tso: Report whether TCP segmentation offload is enabled
302 * set_tso: Turn TCP segmentation offload on or off
Ananda Rajue89e9cf2005-10-18 15:46:41 -0700303 * get_ufo: Report whether UDP fragmentation offload is enabled
304 * set_ufo: Turn UDP fragmentation offload on or off
Linus Torvalds1da177e2005-04-16 15:20:36 -0700305 * self_test: Run specified self-tests
306 * get_strings: Return a set of strings that describe the requested objects
307 * phys_id: Identify the device
308 * get_stats: Return statistics about the device
Jon Wetzela6f9a702005-08-20 17:15:54 -0700309 * get_perm_addr: Gets the permanent hardware address
310 *
Linus Torvalds1da177e2005-04-16 15:20:36 -0700311 * Description:
312 *
313 * get_settings:
314 * @get_settings is passed an &ethtool_cmd to fill in. It returns
315 * an negative errno or zero.
316 *
317 * set_settings:
318 * @set_settings is passed an &ethtool_cmd and should attempt to set
319 * all the settings this device supports. It may return an error value
320 * if something goes wrong (otherwise 0).
321 *
322 * get_eeprom:
323 * Should fill in the magic field. Don't need to check len for zero
324 * or wraparound. Fill in the data argument with the eeprom values
325 * from offset to offset + len. Update len to the amount read.
326 * Returns an error or zero.
327 *
328 * set_eeprom:
329 * Should validate the magic field. Don't need to check len for zero
330 * or wraparound. Update len to the amount written. Returns an error
331 * or zero.
332 */
333struct ethtool_ops {
334 int (*get_settings)(struct net_device *, struct ethtool_cmd *);
335 int (*set_settings)(struct net_device *, struct ethtool_cmd *);
336 void (*get_drvinfo)(struct net_device *, struct ethtool_drvinfo *);
337 int (*get_regs_len)(struct net_device *);
338 void (*get_regs)(struct net_device *, struct ethtool_regs *, void *);
339 void (*get_wol)(struct net_device *, struct ethtool_wolinfo *);
340 int (*set_wol)(struct net_device *, struct ethtool_wolinfo *);
341 u32 (*get_msglevel)(struct net_device *);
342 void (*set_msglevel)(struct net_device *, u32);
343 int (*nway_reset)(struct net_device *);
344 u32 (*get_link)(struct net_device *);
345 int (*get_eeprom_len)(struct net_device *);
346 int (*get_eeprom)(struct net_device *, struct ethtool_eeprom *, u8 *);
347 int (*set_eeprom)(struct net_device *, struct ethtool_eeprom *, u8 *);
348 int (*get_coalesce)(struct net_device *, struct ethtool_coalesce *);
349 int (*set_coalesce)(struct net_device *, struct ethtool_coalesce *);
350 void (*get_ringparam)(struct net_device *, struct ethtool_ringparam *);
351 int (*set_ringparam)(struct net_device *, struct ethtool_ringparam *);
352 void (*get_pauseparam)(struct net_device *, struct ethtool_pauseparam*);
353 int (*set_pauseparam)(struct net_device *, struct ethtool_pauseparam*);
354 u32 (*get_rx_csum)(struct net_device *);
355 int (*set_rx_csum)(struct net_device *, u32);
356 u32 (*get_tx_csum)(struct net_device *);
357 int (*set_tx_csum)(struct net_device *, u32);
358 u32 (*get_sg)(struct net_device *);
359 int (*set_sg)(struct net_device *, u32);
360 u32 (*get_tso)(struct net_device *);
361 int (*set_tso)(struct net_device *, u32);
362 int (*self_test_count)(struct net_device *);
363 void (*self_test)(struct net_device *, struct ethtool_test *, u64 *);
364 void (*get_strings)(struct net_device *, u32 stringset, u8 *);
365 int (*phys_id)(struct net_device *, u32);
366 int (*get_stats_count)(struct net_device *);
367 void (*get_ethtool_stats)(struct net_device *, struct ethtool_stats *, u64 *);
Jon Wetzela6f9a702005-08-20 17:15:54 -0700368 int (*get_perm_addr)(struct net_device *, struct ethtool_perm_addr *, u8 *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700369 int (*begin)(struct net_device *);
370 void (*complete)(struct net_device *);
Ananda Rajue89e9cf2005-10-18 15:46:41 -0700371 u32 (*get_ufo)(struct net_device *);
372 int (*set_ufo)(struct net_device *, u32);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700373};
374
375/* CMDs currently supported */
376#define ETHTOOL_GSET 0x00000001 /* Get settings. */
377#define ETHTOOL_SSET 0x00000002 /* Set settings. */
378#define ETHTOOL_GDRVINFO 0x00000003 /* Get driver info. */
379#define ETHTOOL_GREGS 0x00000004 /* Get NIC registers. */
380#define ETHTOOL_GWOL 0x00000005 /* Get wake-on-lan options. */
381#define ETHTOOL_SWOL 0x00000006 /* Set wake-on-lan options. */
382#define ETHTOOL_GMSGLVL 0x00000007 /* Get driver message level */
383#define ETHTOOL_SMSGLVL 0x00000008 /* Set driver msg level. */
384#define ETHTOOL_NWAY_RST 0x00000009 /* Restart autonegotiation. */
385#define ETHTOOL_GLINK 0x0000000a /* Get link status (ethtool_value) */
386#define ETHTOOL_GEEPROM 0x0000000b /* Get EEPROM data */
387#define ETHTOOL_SEEPROM 0x0000000c /* Set EEPROM data. */
388#define ETHTOOL_GCOALESCE 0x0000000e /* Get coalesce config */
389#define ETHTOOL_SCOALESCE 0x0000000f /* Set coalesce config. */
390#define ETHTOOL_GRINGPARAM 0x00000010 /* Get ring parameters */
391#define ETHTOOL_SRINGPARAM 0x00000011 /* Set ring parameters. */
392#define ETHTOOL_GPAUSEPARAM 0x00000012 /* Get pause parameters */
393#define ETHTOOL_SPAUSEPARAM 0x00000013 /* Set pause parameters. */
394#define ETHTOOL_GRXCSUM 0x00000014 /* Get RX hw csum enable (ethtool_value) */
395#define ETHTOOL_SRXCSUM 0x00000015 /* Set RX hw csum enable (ethtool_value) */
396#define ETHTOOL_GTXCSUM 0x00000016 /* Get TX hw csum enable (ethtool_value) */
397#define ETHTOOL_STXCSUM 0x00000017 /* Set TX hw csum enable (ethtool_value) */
398#define ETHTOOL_GSG 0x00000018 /* Get scatter-gather enable
399 * (ethtool_value) */
400#define ETHTOOL_SSG 0x00000019 /* Set scatter-gather enable
401 * (ethtool_value). */
402#define ETHTOOL_TEST 0x0000001a /* execute NIC self-test. */
403#define ETHTOOL_GSTRINGS 0x0000001b /* get specified string set */
404#define ETHTOOL_PHYS_ID 0x0000001c /* identify the NIC */
405#define ETHTOOL_GSTATS 0x0000001d /* get NIC-specific statistics */
406#define ETHTOOL_GTSO 0x0000001e /* Get TSO enable (ethtool_value) */
407#define ETHTOOL_STSO 0x0000001f /* Set TSO enable (ethtool_value) */
Jon Wetzela6f9a702005-08-20 17:15:54 -0700408#define ETHTOOL_GPERMADDR 0x00000020 /* Get permanent hardware address */
Ananda Rajue89e9cf2005-10-18 15:46:41 -0700409#define ETHTOOL_GUFO 0x00000021 /* Get UFO enable (ethtool_value) */
410#define ETHTOOL_SUFO 0x00000022 /* Set UFO enable (ethtool_value) */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700411
412/* compatibility with older code */
413#define SPARC_ETH_GSET ETHTOOL_GSET
414#define SPARC_ETH_SSET ETHTOOL_SSET
415
416/* Indicates what features are supported by the interface. */
417#define SUPPORTED_10baseT_Half (1 << 0)
418#define SUPPORTED_10baseT_Full (1 << 1)
419#define SUPPORTED_100baseT_Half (1 << 2)
420#define SUPPORTED_100baseT_Full (1 << 3)
421#define SUPPORTED_1000baseT_Half (1 << 4)
422#define SUPPORTED_1000baseT_Full (1 << 5)
423#define SUPPORTED_Autoneg (1 << 6)
424#define SUPPORTED_TP (1 << 7)
425#define SUPPORTED_AUI (1 << 8)
426#define SUPPORTED_MII (1 << 9)
427#define SUPPORTED_FIBRE (1 << 10)
428#define SUPPORTED_BNC (1 << 11)
429#define SUPPORTED_10000baseT_Full (1 << 12)
Andy Fleming00db8182005-07-30 19:31:23 -0400430#define SUPPORTED_Pause (1 << 13)
431#define SUPPORTED_Asym_Pause (1 << 14)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700432
433/* Indicates what features are advertised by the interface. */
434#define ADVERTISED_10baseT_Half (1 << 0)
435#define ADVERTISED_10baseT_Full (1 << 1)
436#define ADVERTISED_100baseT_Half (1 << 2)
437#define ADVERTISED_100baseT_Full (1 << 3)
438#define ADVERTISED_1000baseT_Half (1 << 4)
439#define ADVERTISED_1000baseT_Full (1 << 5)
440#define ADVERTISED_Autoneg (1 << 6)
441#define ADVERTISED_TP (1 << 7)
442#define ADVERTISED_AUI (1 << 8)
443#define ADVERTISED_MII (1 << 9)
444#define ADVERTISED_FIBRE (1 << 10)
445#define ADVERTISED_BNC (1 << 11)
446#define ADVERTISED_10000baseT_Full (1 << 12)
Andy Fleming00db8182005-07-30 19:31:23 -0400447#define ADVERTISED_Pause (1 << 13)
448#define ADVERTISED_Asym_Pause (1 << 14)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700449
450/* The following are all involved in forcing a particular link
451 * mode for the device for setting things. When getting the
452 * devices settings, these indicate the current mode and whether
453 * it was foced up into this mode or autonegotiated.
454 */
455
Michael Chan5b0c76a2005-11-04 08:45:49 -0800456/* The forced speed, 10Mb, 100Mb, gigabit, 2.5Gb, 10GbE. */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700457#define SPEED_10 10
458#define SPEED_100 100
459#define SPEED_1000 1000
Michael Chan5b0c76a2005-11-04 08:45:49 -0800460#define SPEED_2500 2500
Linus Torvalds1da177e2005-04-16 15:20:36 -0700461#define SPEED_10000 10000
462
463/* Duplex, half or full. */
464#define DUPLEX_HALF 0x00
465#define DUPLEX_FULL 0x01
466
467/* Which connector port. */
468#define PORT_TP 0x00
469#define PORT_AUI 0x01
470#define PORT_MII 0x02
471#define PORT_FIBRE 0x03
472#define PORT_BNC 0x04
473
474/* Which transceiver to use. */
475#define XCVR_INTERNAL 0x00
476#define XCVR_EXTERNAL 0x01
477#define XCVR_DUMMY1 0x02
478#define XCVR_DUMMY2 0x03
479#define XCVR_DUMMY3 0x04
480
481/* Enable or disable autonegotiation. If this is set to enable,
482 * the forced link modes above are completely ignored.
483 */
484#define AUTONEG_DISABLE 0x00
485#define AUTONEG_ENABLE 0x01
486
487/* Wake-On-Lan options. */
488#define WAKE_PHY (1 << 0)
489#define WAKE_UCAST (1 << 1)
490#define WAKE_MCAST (1 << 2)
491#define WAKE_BCAST (1 << 3)
492#define WAKE_ARP (1 << 4)
493#define WAKE_MAGIC (1 << 5)
494#define WAKE_MAGICSECURE (1 << 6) /* only meaningful if WAKE_MAGIC */
495
496#endif /* _LINUX_ETHTOOL_H */