2 * Copyright (c) 2008-2011, Intel Corporation.
4 * This program is free software; you can redistribute it and/or modify it
5 * under the terms and conditions of the GNU General Public License,
6 * version 2, as published by the Free Software Foundation.
8 * This program is distributed in the hope it will be useful, but WITHOUT
9 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
13 * You should have received a copy of the GNU General Public License along with
14 * this program; if not, write to the Free Software Foundation, Inc., 59 Temple
15 * Place - Suite 330, Boston, MA 02111-1307 USA.
17 * Author: Lucy Liu <lucy.liu@intel.com>
20 #ifndef __LINUX_DCBNL_H__
21 #define __LINUX_DCBNL_H__
23 #include <linux/types.h>
25 /* IEEE 802.1Qaz std supported values */
26 #define IEEE_8021QAZ_MAX_TCS 8
28 #define IEEE_8021QAZ_TSA_STRICT 0
29 #define IEEE_8021QAZ_TSA_CB_SHAPER 1
30 #define IEEE_8021QAZ_TSA_ETS 2
31 #define IEEE_8021QAZ_TSA_VENDOR 255
33 /* This structure contains the IEEE 802.1Qaz ETS managed object
35 * @willing: willing bit in ETS configuration TLV
36 * @ets_cap: indicates supported capacity of ets feature
37 * @cbs: credit based shaper ets algorithm supported
38 * @tc_tx_bw: tc tx bandwidth indexed by traffic class
39 * @tc_rx_bw: tc rx bandwidth indexed by traffic class
40 * @tc_tsa: TSA Assignment table, indexed by traffic class
41 * @prio_tc: priority assignment table mapping 8021Qp to traffic class
42 * @tc_reco_bw: recommended tc bandwidth indexed by traffic class for TLV
43 * @tc_reco_tsa: recommended tc bandwidth indexed by traffic class for TLV
44 * @reco_prio_tc: recommended tc tx bandwidth indexed by traffic class for TLV
46 * Recommended values are used to set fields in the ETS recommendation TLV
47 * with hardware offloaded LLDP.
50 * TSA Assignment 8 bit identifiers
52 * 1 credit-based shaper
53 * 2 enhanced transmission selection
61 __u8 tc_tx_bw[IEEE_8021QAZ_MAX_TCS];
62 __u8 tc_rx_bw[IEEE_8021QAZ_MAX_TCS];
63 __u8 tc_tsa[IEEE_8021QAZ_MAX_TCS];
64 __u8 prio_tc[IEEE_8021QAZ_MAX_TCS];
65 __u8 tc_reco_bw[IEEE_8021QAZ_MAX_TCS];
66 __u8 tc_reco_tsa[IEEE_8021QAZ_MAX_TCS];
67 __u8 reco_prio_tc[IEEE_8021QAZ_MAX_TCS];
70 /* This structure contains the IEEE 802.1Qaz PFC managed object
72 * @pfc_cap: Indicates the number of traffic classes on the local device
73 * that may simultaneously have PFC enabled.
74 * @pfc_en: bitmap indicating pfc enabled traffic classes
75 * @mbc: enable macsec bypass capability
76 * @delay: the allowance made for a round-trip propagation delay of the
78 * @requests: count of the sent pfc frames
79 * @indications: count of the received pfc frames
86 __u64 requests[IEEE_8021QAZ_MAX_TCS];
87 __u64 indications[IEEE_8021QAZ_MAX_TCS];
90 /* CEE DCBX std supported values */
91 #define CEE_DCBX_MAX_PGS 8
92 #define CEE_DCBX_MAX_PRIO 8
95 * struct cee_pg - CEE Priority-Group managed object
97 * @willing: willing bit in the PG tlv
98 * @error: error bit in the PG tlv
99 * @pg_en: enable bit of the PG feature
100 * @tcs_supported: number of traffic classes supported
101 * @pg_bw: bandwidth percentage for each priority group
102 * @prio_pg: priority to PG mapping indexed by priority
109 __u8 pg_bw[CEE_DCBX_MAX_PGS];
110 __u8 prio_pg[CEE_DCBX_MAX_PGS];
114 * struct cee_pfc - CEE PFC managed object
116 * @willing: willing bit in the PFC tlv
117 * @error: error bit in the PFC tlv
118 * @pfc_en: bitmap indicating pfc enabled traffic classes
119 * @tcs_supported: number of traffic classes supported
128 /* IEEE 802.1Qaz std supported values */
129 #define IEEE_8021QAZ_APP_SEL_ETHERTYPE 1
130 #define IEEE_8021QAZ_APP_SEL_STREAM 2
131 #define IEEE_8021QAZ_APP_SEL_DGRAM 3
132 #define IEEE_8021QAZ_APP_SEL_ANY 4
134 /* This structure contains the IEEE 802.1Qaz APP managed object. This
135 * object is also used for the CEE std as well. There is no difference
136 * between the objects.
138 * @selector: protocol identifier type
139 * @protocol: protocol of type indicated
140 * @priority: 3-bit unsigned integer indicating priority
143 * Selector field values
146 * 2 Well known port number over TCP or SCTP
147 * 3 Well known port number over UDP or DCCP
148 * 4 Well known port number over TCP, SCTP, UDP, or DCCP
158 * struct dcb_peer_app_info - APP feature information sent by the peer
160 * @willing: willing bit in the peer APP tlv
161 * @error: error bit in the peer APP tlv
163 * In addition to this information the full peer APP tlv also contains
164 * a table of 'app_count' APP objects defined above.
166 struct dcb_peer_app_info {
178 * enum dcbnl_commands - supported DCB commands
180 * @DCB_CMD_UNDEFINED: unspecified command to catch errors
181 * @DCB_CMD_GSTATE: request the state of DCB in the device
182 * @DCB_CMD_SSTATE: set the state of DCB in the device
183 * @DCB_CMD_PGTX_GCFG: request the priority group configuration for Tx
184 * @DCB_CMD_PGTX_SCFG: set the priority group configuration for Tx
185 * @DCB_CMD_PGRX_GCFG: request the priority group configuration for Rx
186 * @DCB_CMD_PGRX_SCFG: set the priority group configuration for Rx
187 * @DCB_CMD_PFC_GCFG: request the priority flow control configuration
188 * @DCB_CMD_PFC_SCFG: set the priority flow control configuration
189 * @DCB_CMD_SET_ALL: apply all changes to the underlying device
190 * @DCB_CMD_GPERM_HWADDR: get the permanent MAC address of the underlying
191 * device. Only useful when using bonding.
192 * @DCB_CMD_GCAP: request the DCB capabilities of the device
193 * @DCB_CMD_GNUMTCS: get the number of traffic classes currently supported
194 * @DCB_CMD_SNUMTCS: set the number of traffic classes
195 * @DCB_CMD_GBCN: set backward congestion notification configuration
196 * @DCB_CMD_SBCN: get backward congestion notification configration.
197 * @DCB_CMD_GAPP: get application protocol configuration
198 * @DCB_CMD_SAPP: set application protocol configuration
199 * @DCB_CMD_IEEE_SET: set IEEE 802.1Qaz configuration
200 * @DCB_CMD_IEEE_GET: get IEEE 802.1Qaz configuration
201 * @DCB_CMD_GDCBX: get DCBX engine configuration
202 * @DCB_CMD_SDCBX: set DCBX engine configuration
203 * @DCB_CMD_GFEATCFG: get DCBX features flags
204 * @DCB_CMD_SFEATCFG: set DCBX features negotiation flags
205 * @DCB_CMD_CEE_GET: get CEE aggregated configuration
207 enum dcbnl_commands {
223 DCB_CMD_GPERM_HWADDR,
251 DCB_CMD_MAX = __DCB_CMD_ENUM_MAX - 1,
255 * enum dcbnl_attrs - DCB top-level netlink attributes
257 * @DCB_ATTR_UNDEFINED: unspecified attribute to catch errors
258 * @DCB_ATTR_IFNAME: interface name of the underlying device (NLA_STRING)
259 * @DCB_ATTR_STATE: enable state of DCB in the device (NLA_U8)
260 * @DCB_ATTR_PFC_STATE: enable state of PFC in the device (NLA_U8)
261 * @DCB_ATTR_PFC_CFG: priority flow control configuration (NLA_NESTED)
262 * @DCB_ATTR_NUM_TC: number of traffic classes supported in the device (NLA_U8)
263 * @DCB_ATTR_PG_CFG: priority group configuration (NLA_NESTED)
264 * @DCB_ATTR_SET_ALL: bool to commit changes to hardware or not (NLA_U8)
265 * @DCB_ATTR_PERM_HWADDR: MAC address of the physical device (NLA_NESTED)
266 * @DCB_ATTR_CAP: DCB capabilities of the device (NLA_NESTED)
267 * @DCB_ATTR_NUMTCS: number of traffic classes supported (NLA_NESTED)
268 * @DCB_ATTR_BCN: backward congestion notification configuration (NLA_NESTED)
269 * @DCB_ATTR_IEEE: IEEE 802.1Qaz supported attributes (NLA_NESTED)
270 * @DCB_ATTR_DCBX: DCBX engine configuration in the device (NLA_U8)
271 * @DCB_ATTR_FEATCFG: DCBX features flags (NLA_NESTED)
272 * @DCB_ATTR_CEE: CEE std supported attributes (NLA_NESTED)
284 DCB_ATTR_PERM_HWADDR,
290 /* IEEE std attributes */
296 /* CEE nested attributes */
300 DCB_ATTR_MAX = __DCB_ATTR_ENUM_MAX - 1,
304 * enum ieee_attrs - IEEE 802.1Qaz get/set attributes
306 * @DCB_ATTR_IEEE_UNSPEC: unspecified
307 * @DCB_ATTR_IEEE_ETS: negotiated ETS configuration
308 * @DCB_ATTR_IEEE_PFC: negotiated PFC configuration
309 * @DCB_ATTR_IEEE_APP_TABLE: negotiated APP configuration
310 * @DCB_ATTR_IEEE_PEER_ETS: peer ETS configuration - get only
311 * @DCB_ATTR_IEEE_PEER_PFC: peer PFC configuration - get only
312 * @DCB_ATTR_IEEE_PEER_APP: peer APP tlv - get only
315 DCB_ATTR_IEEE_UNSPEC,
318 DCB_ATTR_IEEE_APP_TABLE,
319 DCB_ATTR_IEEE_PEER_ETS,
320 DCB_ATTR_IEEE_PEER_PFC,
321 DCB_ATTR_IEEE_PEER_APP,
324 #define DCB_ATTR_IEEE_MAX (__DCB_ATTR_IEEE_MAX - 1)
326 enum ieee_attrs_app {
327 DCB_ATTR_IEEE_APP_UNSPEC,
329 __DCB_ATTR_IEEE_APP_MAX
331 #define DCB_ATTR_IEEE_APP_MAX (__DCB_ATTR_IEEE_APP_MAX - 1)
334 * enum cee_attrs - CEE DCBX get attributes
336 * @DCB_ATTR_CEE_UNSPEC: unspecified
337 * @DCB_ATTR_CEE_PEER_PG: peer PG configuration - get only
338 * @DCB_ATTR_CEE_PEER_PFC: peer PFC configuration - get only
339 * @DCB_ATTR_CEE_PEER_APP: peer APP tlv - get only
343 DCB_ATTR_CEE_PEER_PG,
344 DCB_ATTR_CEE_PEER_PFC,
345 DCB_ATTR_CEE_PEER_APP_TABLE,
348 #define DCB_ATTR_CEE_MAX (__DCB_ATTR_CEE_MAX - 1)
351 DCB_ATTR_CEE_PEER_APP_UNSPEC,
352 DCB_ATTR_CEE_PEER_APP_INFO,
353 DCB_ATTR_CEE_PEER_APP,
354 __DCB_ATTR_CEE_PEER_APP_MAX
356 #define DCB_ATTR_CEE_PEER_APP_MAX (__DCB_ATTR_CEE_PEER_APP_MAX - 1)
359 * enum dcbnl_pfc_attrs - DCB Priority Flow Control user priority nested attrs
361 * @DCB_PFC_UP_ATTR_UNDEFINED: unspecified attribute to catch errors
362 * @DCB_PFC_UP_ATTR_0: Priority Flow Control value for User Priority 0 (NLA_U8)
363 * @DCB_PFC_UP_ATTR_1: Priority Flow Control value for User Priority 1 (NLA_U8)
364 * @DCB_PFC_UP_ATTR_2: Priority Flow Control value for User Priority 2 (NLA_U8)
365 * @DCB_PFC_UP_ATTR_3: Priority Flow Control value for User Priority 3 (NLA_U8)
366 * @DCB_PFC_UP_ATTR_4: Priority Flow Control value for User Priority 4 (NLA_U8)
367 * @DCB_PFC_UP_ATTR_5: Priority Flow Control value for User Priority 5 (NLA_U8)
368 * @DCB_PFC_UP_ATTR_6: Priority Flow Control value for User Priority 6 (NLA_U8)
369 * @DCB_PFC_UP_ATTR_7: Priority Flow Control value for User Priority 7 (NLA_U8)
370 * @DCB_PFC_UP_ATTR_MAX: highest attribute number currently defined
371 * @DCB_PFC_UP_ATTR_ALL: apply to all priority flow control attrs (NLA_FLAG)
374 enum dcbnl_pfc_up_attrs {
375 DCB_PFC_UP_ATTR_UNDEFINED,
387 __DCB_PFC_UP_ATTR_ENUM_MAX,
388 DCB_PFC_UP_ATTR_MAX = __DCB_PFC_UP_ATTR_ENUM_MAX - 1,
392 * enum dcbnl_pg_attrs - DCB Priority Group attributes
394 * @DCB_PG_ATTR_UNDEFINED: unspecified attribute to catch errors
395 * @DCB_PG_ATTR_TC_0: Priority Group Traffic Class 0 configuration (NLA_NESTED)
396 * @DCB_PG_ATTR_TC_1: Priority Group Traffic Class 1 configuration (NLA_NESTED)
397 * @DCB_PG_ATTR_TC_2: Priority Group Traffic Class 2 configuration (NLA_NESTED)
398 * @DCB_PG_ATTR_TC_3: Priority Group Traffic Class 3 configuration (NLA_NESTED)
399 * @DCB_PG_ATTR_TC_4: Priority Group Traffic Class 4 configuration (NLA_NESTED)
400 * @DCB_PG_ATTR_TC_5: Priority Group Traffic Class 5 configuration (NLA_NESTED)
401 * @DCB_PG_ATTR_TC_6: Priority Group Traffic Class 6 configuration (NLA_NESTED)
402 * @DCB_PG_ATTR_TC_7: Priority Group Traffic Class 7 configuration (NLA_NESTED)
403 * @DCB_PG_ATTR_TC_MAX: highest attribute number currently defined
404 * @DCB_PG_ATTR_TC_ALL: apply to all traffic classes (NLA_NESTED)
405 * @DCB_PG_ATTR_BW_ID_0: Percent of link bandwidth for Priority Group 0 (NLA_U8)
406 * @DCB_PG_ATTR_BW_ID_1: Percent of link bandwidth for Priority Group 1 (NLA_U8)
407 * @DCB_PG_ATTR_BW_ID_2: Percent of link bandwidth for Priority Group 2 (NLA_U8)
408 * @DCB_PG_ATTR_BW_ID_3: Percent of link bandwidth for Priority Group 3 (NLA_U8)
409 * @DCB_PG_ATTR_BW_ID_4: Percent of link bandwidth for Priority Group 4 (NLA_U8)
410 * @DCB_PG_ATTR_BW_ID_5: Percent of link bandwidth for Priority Group 5 (NLA_U8)
411 * @DCB_PG_ATTR_BW_ID_6: Percent of link bandwidth for Priority Group 6 (NLA_U8)
412 * @DCB_PG_ATTR_BW_ID_7: Percent of link bandwidth for Priority Group 7 (NLA_U8)
413 * @DCB_PG_ATTR_BW_ID_MAX: highest attribute number currently defined
414 * @DCB_PG_ATTR_BW_ID_ALL: apply to all priority groups (NLA_FLAG)
417 enum dcbnl_pg_attrs {
418 DCB_PG_ATTR_UNDEFINED,
439 DCB_PG_ATTR_BW_ID_MAX,
440 DCB_PG_ATTR_BW_ID_ALL,
442 __DCB_PG_ATTR_ENUM_MAX,
443 DCB_PG_ATTR_MAX = __DCB_PG_ATTR_ENUM_MAX - 1,
447 * enum dcbnl_tc_attrs - DCB Traffic Class attributes
449 * @DCB_TC_ATTR_PARAM_UNDEFINED: unspecified attribute to catch errors
450 * @DCB_TC_ATTR_PARAM_PGID: (NLA_U8) Priority group the traffic class belongs to
451 * Valid values are: 0-7
452 * @DCB_TC_ATTR_PARAM_UP_MAPPING: (NLA_U8) Traffic class to user priority map
453 * Some devices may not support changing the
454 * user priority map of a TC.
455 * @DCB_TC_ATTR_PARAM_STRICT_PRIO: (NLA_U8) Strict priority setting
459 * @DCB_TC_ATTR_PARAM_BW_PCT: optional - (NLA_U8) If supported by the device and
460 * not configured to use link strict priority,
461 * this is the percentage of bandwidth of the
462 * priority group this traffic class belongs to
463 * @DCB_TC_ATTR_PARAM_ALL: (NLA_FLAG) all traffic class parameters
466 enum dcbnl_tc_attrs {
467 DCB_TC_ATTR_PARAM_UNDEFINED,
469 DCB_TC_ATTR_PARAM_PGID,
470 DCB_TC_ATTR_PARAM_UP_MAPPING,
471 DCB_TC_ATTR_PARAM_STRICT_PRIO,
472 DCB_TC_ATTR_PARAM_BW_PCT,
473 DCB_TC_ATTR_PARAM_ALL,
475 __DCB_TC_ATTR_PARAM_ENUM_MAX,
476 DCB_TC_ATTR_PARAM_MAX = __DCB_TC_ATTR_PARAM_ENUM_MAX - 1,
480 * enum dcbnl_cap_attrs - DCB Capability attributes
482 * @DCB_CAP_ATTR_UNDEFINED: unspecified attribute to catch errors
483 * @DCB_CAP_ATTR_ALL: (NLA_FLAG) all capability parameters
484 * @DCB_CAP_ATTR_PG: (NLA_U8) device supports Priority Groups
485 * @DCB_CAP_ATTR_PFC: (NLA_U8) device supports Priority Flow Control
486 * @DCB_CAP_ATTR_UP2TC: (NLA_U8) device supports user priority to
487 * traffic class mapping
488 * @DCB_CAP_ATTR_PG_TCS: (NLA_U8) bitmap where each bit represents a
489 * number of traffic classes the device
490 * can be configured to use for Priority Groups
491 * @DCB_CAP_ATTR_PFC_TCS: (NLA_U8) bitmap where each bit represents a
492 * number of traffic classes the device can be
493 * configured to use for Priority Flow Control
494 * @DCB_CAP_ATTR_GSP: (NLA_U8) device supports group strict priority
495 * @DCB_CAP_ATTR_BCN: (NLA_U8) device supports Backwards Congestion
497 * @DCB_CAP_ATTR_DCBX: (NLA_U8) device supports DCBX engine
500 enum dcbnl_cap_attrs {
501 DCB_CAP_ATTR_UNDEFINED,
507 DCB_CAP_ATTR_PFC_TCS,
512 __DCB_CAP_ATTR_ENUM_MAX,
513 DCB_CAP_ATTR_MAX = __DCB_CAP_ATTR_ENUM_MAX - 1,
517 * DCBX capability flags
519 * @DCB_CAP_DCBX_HOST: DCBX negotiation is performed by the host LLDP agent.
520 * 'set' routines are used to configure the device with
521 * the negotiated parameters
523 * @DCB_CAP_DCBX_LLD_MANAGED: DCBX negotiation is not performed in the host but
525 * 'get' routines are used to retrieve the
526 * negotiated parameters
527 * 'set' routines can be used to set the initial
528 * negotiation configuration
530 * @DCB_CAP_DCBX_VER_CEE: for a non-host DCBX engine, indicates the engine
531 * supports the CEE protocol flavor
533 * @DCB_CAP_DCBX_VER_IEEE: for a non-host DCBX engine, indicates the engine
534 * supports the IEEE protocol flavor
536 * @DCB_CAP_DCBX_STATIC: for a non-host DCBX engine, indicates the engine
537 * supports static configuration (i.e no actual
538 * negotiation is performed negotiated parameters equal
539 * the initial configuration)
542 #define DCB_CAP_DCBX_HOST 0x01
543 #define DCB_CAP_DCBX_LLD_MANAGED 0x02
544 #define DCB_CAP_DCBX_VER_CEE 0x04
545 #define DCB_CAP_DCBX_VER_IEEE 0x08
546 #define DCB_CAP_DCBX_STATIC 0x10
549 * enum dcbnl_numtcs_attrs - number of traffic classes
551 * @DCB_NUMTCS_ATTR_UNDEFINED: unspecified attribute to catch errors
552 * @DCB_NUMTCS_ATTR_ALL: (NLA_FLAG) all traffic class attributes
553 * @DCB_NUMTCS_ATTR_PG: (NLA_U8) number of traffic classes used for
555 * @DCB_NUMTCS_ATTR_PFC: (NLA_U8) number of traffic classes which can
556 * support priority flow control
558 enum dcbnl_numtcs_attrs {
559 DCB_NUMTCS_ATTR_UNDEFINED,
564 __DCB_NUMTCS_ATTR_ENUM_MAX,
565 DCB_NUMTCS_ATTR_MAX = __DCB_NUMTCS_ATTR_ENUM_MAX - 1,
568 enum dcbnl_bcn_attrs{
569 DCB_BCN_ATTR_UNDEFINED = 0,
598 __DCB_BCN_ATTR_ENUM_MAX,
599 DCB_BCN_ATTR_MAX = __DCB_BCN_ATTR_ENUM_MAX - 1,
603 * enum dcb_general_attr_values - general DCB attribute values
605 * @DCB_ATTR_UNDEFINED: value used to indicate an attribute is not supported
608 enum dcb_general_attr_values {
609 DCB_ATTR_VALUE_UNDEFINED = 0xff
612 #define DCB_APP_IDTYPE_ETHTYPE 0x00
613 #define DCB_APP_IDTYPE_PORTNUM 0x01
614 enum dcbnl_app_attrs {
615 DCB_APP_ATTR_UNDEFINED,
619 DCB_APP_ATTR_PRIORITY,
621 __DCB_APP_ATTR_ENUM_MAX,
622 DCB_APP_ATTR_MAX = __DCB_APP_ATTR_ENUM_MAX - 1,
626 * enum dcbnl_featcfg_attrs - features conifiguration flags
628 * @DCB_FEATCFG_ATTR_UNDEFINED: unspecified attribute to catch errors
629 * @DCB_FEATCFG_ATTR_ALL: (NLA_FLAG) all features configuration attributes
630 * @DCB_FEATCFG_ATTR_PG: (NLA_U8) configuration flags for priority groups
631 * @DCB_FEATCFG_ATTR_PFC: (NLA_U8) configuration flags for priority
633 * @DCB_FEATCFG_ATTR_APP: (NLA_U8) configuration flags for application TLV
636 #define DCB_FEATCFG_ERROR 0x01 /* error in feature resolution */
637 #define DCB_FEATCFG_ENABLE 0x02 /* enable feature */
638 #define DCB_FEATCFG_WILLING 0x04 /* feature is willing */
639 #define DCB_FEATCFG_ADVERTISE 0x08 /* advertise feature */
640 enum dcbnl_featcfg_attrs {
641 DCB_FEATCFG_ATTR_UNDEFINED,
642 DCB_FEATCFG_ATTR_ALL,
644 DCB_FEATCFG_ATTR_PFC,
645 DCB_FEATCFG_ATTR_APP,
647 __DCB_FEATCFG_ATTR_ENUM_MAX,
648 DCB_FEATCFG_ATTR_MAX = __DCB_FEATCFG_ATTR_ENUM_MAX - 1,
651 #endif /* __LINUX_DCBNL_H__ */