Page is loading ...
Broadcom 88690-PG107a-PUB
August 10, 2020
BCM88690
Packet Processing
Programming Guide
BCM8869X
BCM8880X
BCM8848X
BCM8828X
Broadcom, the pulse logo, Connecting everything, Avago Technologies, Avago, the A logo, BroadSync, and StrataDNX are
among the trademarks of Broadcom and/or its affiliates in the United States, certain other countries, and/or the EU.
Copyright © 2018–2020 Broadcom. All Rights Reserved.
The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries. For more information, please visit www.broadcom.com.
Broadcom reserves the right to make changes without further notice to any products or data herein to improve reliability,
function, or design. Information furnished by Broadcom is believed to be accurate and reliable. However, Broadcom does
not assume any liability arising out of the application or use of this information, nor the application or use of any product or
circuit described herein, neither does it convey any license under its patent rights nor the rights of others.
BCM88690 Programming Guide Packet Processing
Broadcom 88690-PG107a-PUB
2
Broadcom 88690-PG107a-PUB
3
BCM88690 Programming Guide Packet Processing
Table of Contents
Chapter 1: Overview ......................................................................................................................... 45
1.1 Introduction.............................................................................................................................................................45
Chapter 2: Ports and Generalized Ports .........................................................................................46
2.1 Packet Processing Ports........................................................................................................................................47
2.1.1 SOC Properties ...............................................................................................................................................49
2.1.2 Configuration Flow ..........................................................................................................................................49
2.1.3 Shell Commands.............................................................................................................................................50
2.1.4 Application Reference.....................................................................................................................................50
2.2 CPU Processing Out-Ports.....................................................................................................................................51
2.2.1 SOC Properties ...............................................................................................................................................52
2.2.2 Configuration Flow ..........................................................................................................................................52
2.2.3 Shell Commands.............................................................................................................................................52
2.2.4 Application Reference.....................................................................................................................................52
2.3 RAW Processing Ports...........................................................................................................................................52
2.3.1 SOC Properties ...............................................................................................................................................52
2.3.2 Configuration Flow ..........................................................................................................................................52
2.3.3 Shell Commands.............................................................................................................................................53
2.4 MPLS Raw Processing Ports.................................................................................................................................53
2.4.1 SOC Properties ...............................................................................................................................................53
2.4.2 Configuration Flow ..........................................................................................................................................53
2.4.3 Shell Commands.............................................................................................................................................54
2.4.4 Application Reference.....................................................................................................................................54
Chapter 3: L2 and L3 Ports (GPORTs) ............................................................................................55
3.1 GPORT Interfaces ...................................................................................................................................................55
3.2 Gport Encoding of a Logical Interface..................................................................................................................55
3.3 L3 Interface..............................................................................................................................................................58
3.3.1 L3 Interface – Subtypes ..................................................................................................................................59
Chapter 4: MC Encapsulation Extension ........................................................................................60
4.1 Introduction.............................................................................................................................................................60
4.2 Configuration Flow .................................................................................................................................................61
4.3 Shell Commands.....................................................................................................................................................61
4.4 Application Reference............................................................................................................................................61
4.5 API Descriptions .....................................................................................................................................................61
Chapter 5: Modular Database Profile .............................................................................................. 62
5.1 Introduction.............................................................................................................................................................62
5.2 SOC Properties........................................................................................................................................................62
5.3 MDB Batch Optimization ........................................................................................................................................62
Broadcom 88690-PG107a-PUB
4
BCM88690 Programming Guide Packet Processing
5.3.1 SOC Properties ...............................................................................................................................................62
5.3.2 Configuration Flow ..........................................................................................................................................62
5.3.3 Shell Commands.............................................................................................................................................63
Chapter 6: Logical Interface (LIF) Management ............................................................................. 64
6.1 Introduction.............................................................................................................................................................64
6.2 Application Configuration Checklist.....................................................................................................................65
6.3 Global LIF-ID Management.....................................................................................................................................65
6.3.1 Shell Commands.............................................................................................................................................65
6.4 EEDB Management.................................................................................................................................................66
6.4.1 SOC Properties ...............................................................................................................................................68
6.4.2 Configuration Flow ..........................................................................................................................................68
6.4.3 Shell Commands.............................................................................................................................................68
6.4.4 Application Reference.....................................................................................................................................68
6.4.5 API Descriptions .............................................................................................................................................68
6.5 LIF Profile Resources.............................................................................................................................................68
6.5.1 In-LIF Profile ...................................................................................................................................................69
6.5.2 SOC Properties ...............................................................................................................................................70
6.5.3 Out-LIF ERPP Profile ......................................................................................................................................70
6.5.4 Out-LIF ETPP Profile ......................................................................................................................................70
Chapter 7: L2 VPN (VSI) Object Management ................................................................................ 71
Chapter 8: FEC and ECMP Management ........................................................................................72
8.1 FEC Management....................................................................................................................................................72
8.2 ECMP Management.................................................................................................................................................72
Chapter 9: QoS ..................................................................................................................................73
9.1 Introduction.............................................................................................................................................................73
9.2 Application Configuration Checklist.....................................................................................................................73
9.3 Ingress PHB/Remarking .........................................................................................................................................73
9.3.1 SOC Properties ...............................................................................................................................................76
9.3.2 Configuration Flow ..........................................................................................................................................76
9.3.3 Shell Commands.............................................................................................................................................79
9.3.4 Application Reference.....................................................................................................................................79
9.4 Ingress VLAN Translation VLAN-PCP QoS ..........................................................................................................80
9.4.1 SOC Properties ...............................................................................................................................................80
9.4.2 Configuration Flow ..........................................................................................................................................80
9.4.3 Shell Commands.............................................................................................................................................81
9.4.4 Application Reference.....................................................................................................................................81
9.5 Ingress VLAN Translation Policer QoS.................................................................................................................81
9.5.1 SOC Properties ...............................................................................................................................................81
9.5.2 Configuration Flow ..........................................................................................................................................81
Broadcom 88690-PG107a-PUB
5
BCM88690 Programming Guide Packet Processing
9.5.3 Shell Commands.............................................................................................................................................82
9.5.4 Application Reference.....................................................................................................................................82
9.6 Explicit Congestion Notification............................................................................................................................83
9.6.1 SOC Properties ...............................................................................................................................................83
9.6.2 Configuration Flow ..........................................................................................................................................84
9.6.3 Shell Commands.............................................................................................................................................84
9.6.4 Application Reference.....................................................................................................................................85
9.7 Ingress TTL..............................................................................................................................................................85
9.7.1 SoC Properties................................................................................................................................................85
9.7.2 Configuration Flow ..........................................................................................................................................85
9.7.3 Shell Commands.............................................................................................................................................85
9.7.4 Application Reference.....................................................................................................................................86
9.8 Egress Policer QoS.................................................................................................................................................86
9.9 Egress OAM QoS ....................................................................................................................................................86
9.10 Egress Marking, Remarking, and Inheritance ....................................................................................................86
9.10.1 Forwarding Plus One Remarking..................................................................................................................87
9.10.2 Routing DSCP Preserve ...............................................................................................................................87
9.10.3 SOC Properties.............................................................................................................................................88
9.10.4 Configuration Flow ........................................................................................................................................88
9.10.5 Shell Commands...........................................................................................................................................91
9.10.6 Application Reference...................................................................................................................................91
9.11 Egress MPLS PHP QoS ........................................................................................................................................93
9.11.1 SOC Properties.............................................................................................................................................93
9.11.2 Configuration Flow ........................................................................................................................................93
9.11.3 Shell Commands...........................................................................................................................................94
9.11.4 Application Reference...................................................................................................................................94
9.12 Egress TTL.............................................................................................................................................................95
9.12.1 SOC Properties.............................................................................................................................................95
9.12.2 Configuration Flow ........................................................................................................................................95
9.12.3 Shell Commands...........................................................................................................................................95
9.12.4 Application Reference...................................................................................................................................96
9.13 Egress VLAN Translation VLAN-PCP QOS.........................................................................................................96
9.13.1 SOC Properties.............................................................................................................................................96
9.13.2 Configuration Flow ........................................................................................................................................96
9.13.3 Shell Commands...........................................................................................................................................96
9.13.4 Application Reference...................................................................................................................................96
9.14 Egress CoS Remapping .......................................................................................................................................96
9.14.1 SOC Properties.............................................................................................................................................97
9.14.2 Configuration Flow ........................................................................................................................................97
9.14.3 Shell Commands...........................................................................................................................................97
Broadcom 88690-PG107a-PUB
6
BCM88690 Programming Guide Packet Processing
9.14.4 Application Reference...................................................................................................................................97
9.15 MPLS Ingress Swap QoS......................................................................................................................................98
9.15.1 SOC Properties.............................................................................................................................................98
9.15.2 Configuration Flow ........................................................................................................................................98
9.15.3 Shell Commands...........................................................................................................................................98
9.15.4 Application Reference...................................................................................................................................99
9.16 Ingress Explicit Null Label QoS Attributes.........................................................................................................99
9.16.1 SOC properties .............................................................................................................................................99
9.16.2 Configuration Flow ........................................................................................................................................99
9.16.3 Shell Commands...........................................................................................................................................99
9.16.4 Application Reference...................................................................................................................................99
9.17 API Descriptions .................................................................................................................................................100
9.17.1 bcm_qos_* ..................................................................................................................................................100
Chapter 10: Field Processor ..........................................................................................................101
10.1 Introduction .........................................................................................................................................................101
10.1.1 Field Groups ...............................................................................................................................................101
10.1.1.1 Qualifiers...........................................................................................................................................101
10.1.1.2 Preselectors......................................................................................................................................101
10.1.1.3 Lookups ............................................................................................................................................102
10.1.1.4 Actions ..............................................................................................................................................102
10.1.2 Application Configuration Checklist ............................................................................................................103
10.2 Field Groups........................................................................................................................................................103
10.2.1 SOC Properties...........................................................................................................................................103
10.2.2 Configuration Flow ......................................................................................................................................104
10.2.3 Application Reference.................................................................................................................................104
10.3 Contexts...............................................................................................................................................................104
10.3.1 Context Selection (Presel) ..........................................................................................................................104
10.3.2 Adding Contexts..........................................................................................................................................104
10.3.3 Context Searching ......................................................................................................................................105
10.3.4 Attach Field Group to a Context..................................................................................................................105
10.3.5 SOC Properties...........................................................................................................................................105
10.3.6 Configuration Flow ......................................................................................................................................105
10.3.7 Application Reference.................................................................................................................................106
10.4 Qualifiers..............................................................................................................................................................106
10.4.1 Usage Flow .................................................................................................................................................106
10.4.2 User-Defined Qualifiers...............................................................................................................................107
10.4.3 Raw Qualifiers.............................................................................................................................................107
10.4.4 Configuration Flow ......................................................................................................................................107
10.4.5 Application Reference.................................................................................................................................108
10.4.6 Predefined Qualifiers ..................................................................................................................................108
Broadcom 88690-PG107a-PUB
7
BCM88690 Programming Guide Packet Processing
10.4.7 Range Qualifiers .........................................................................................................................................108
10.4.8 SOC Properties...........................................................................................................................................108
10.4.9 Configuration Flow ......................................................................................................................................109
10.4.10 Application Reference...............................................................................................................................109
10.5 Actions.................................................................................................................................................................110
10.5.1 Predefined Actions......................................................................................................................................110
10.5.2 User-Defined Actions ..................................................................................................................................110
10.6 Raw Action...........................................................................................................................................................110
10.6.1 Action Priority ..............................................................................................................................................111
10.6.2 SOC Properties...........................................................................................................................................113
10.6.3 Configuration Flow ......................................................................................................................................114
10.6.4 Application Reference.................................................................................................................................114
10.7 FG Qualifier/Action Offset..................................................................................................................................115
10.7.1 SOC Properties...........................................................................................................................................115
10.7.2 Configuration Flow ......................................................................................................................................115
10.7.3 Application Reference.................................................................................................................................115
10.8 Advanced TCAM API...........................................................................................................................................116
10.8.1 TCAM Bank Allocation Mode ......................................................................................................................116
10.8.2 TCAM Bank Allocation Mode Code Sample ...............................................................................................116
10.9 TCAM Bank Evacuation......................................................................................................................................117
10.9.1 TCAM Bank Evacuation API .......................................................................................................................117
10.9.2 TCAM Bank Evacuation Code Sample .......................................................................................................117
10.10 TCAM Hit Indication..........................................................................................................................................118
10.10.1 TCAM Hit Indication API ...........................................................................................................................118
10.10.2 TCAM Hit Indication Sample Code ...........................................................................................................118
10.11 Direct Extraction ...............................................................................................................................................119
10.11.1 SOC Properties.........................................................................................................................................119
10.11.2 Configuration Flow ....................................................................................................................................119
10.11.3 Application Reference...............................................................................................................................120
10.12 Cascading..........................................................................................................................................................121
10.12.1 Result Cascading......................................................................................................................................121
10.12.1.1 Using Standard Results ..................................................................................................................121
10.12.1.2 Using Void Actions..........................................................................................................................121
10.12.2 iPMF1/2 to iPMF3 Cascading ...................................................................................................................122
10.12.2.1 Standard Results ............................................................................................................................122
10.12.2.2 Void Results....................................................................................................................................122
10.12.3 Ingress to Egress Cascading (UDH) .........................................................................................................122
10.12.4 Context Update .........................................................................................................................................124
10.12.5 SOC Properties.........................................................................................................................................124
10.12.6 Configuration Flow ....................................................................................................................................124
Broadcom 88690-PG107a-PUB
8
BCM88690 Programming Guide Packet Processing
10.12.7 Application Reference...............................................................................................................................125
10.13 Field Extraction Macro......................................................................................................................................125
10.13.1 FEM Configuration ....................................................................................................................................126
10.13.1.1 FEM Input Selection .......................................................................................................................126
10.13.1.2 Action Selection ..............................................................................................................................126
10.13.1.3 FEM Action Configuration...............................................................................................................126
10.13.1.4 Invalidating FEMs by Context .........................................................................................................127
10.13.2 SOC Properties.........................................................................................................................................127
10.13.3 Operation and Configuration.....................................................................................................................127
10.13.4 Configuration Flow ....................................................................................................................................127
10.13.5 Application Reference...............................................................................................................................128
10.14 Enhanced Field Extraction Shifter...................................................................................................................129
10.14.1 Added EFES Configuration.......................................................................................................................130
10.14.1.1 EFES Condition ..............................................................................................................................130
10.14.1.2 EFES Configuration ........................................................................................................................130
10.14.2 Configuration Flow ....................................................................................................................................131
10.14.2.1 Different Action Types for Different Contexts .................................................................................131
10.14.2.2 Multiple Actions Using the Same Bits .............................................................................................132
10.14.2.3 Using Different Actions for Different Entries ...................................................................................132
10.14.2.4 Using More Than One Bit Condition for Direct Extraction ..............................................................133
10.14.3 SOC Properties.........................................................................................................................................133
10.14.4 Application Reference...............................................................................................................................133
10.15 Hash ...................................................................................................................................................................134
10.15.1 SOC Properties.........................................................................................................................................135
10.15.2 Configuration Flow ....................................................................................................................................135
10.15.3 Application Reference...............................................................................................................................136
10.16 Compare.............................................................................................................................................................136
10.16.1 SOC Properties.........................................................................................................................................137
10.16.2 Configuration Flow ....................................................................................................................................137
10.16.3 Application Reference...............................................................................................................................139
10.17 Exact Match Lookup .........................................................................................................................................139
10.17.1 EXEM Field Group ....................................................................................................................................139
10.17.1.1 SOC Properties...............................................................................................................................140
10.17.1.2 Configuration Flow..........................................................................................................................140
10.18 ACE—Egress PMF Extension..........................................................................................................................140
10.18.1 SOC Properties.........................................................................................................................................141
10.18.2 Configuration Flow ....................................................................................................................................141
10.18.3 Application Reference...............................................................................................................................141
10.19 Constant Field Group .......................................................................................................................................142
10.19.1 SOC Properties.........................................................................................................................................142
Broadcom 88690-PG107a-PUB
9
BCM88690 Programming Guide Packet Processing
10.19.2 Configuration Flow ....................................................................................................................................142
10.19.3 Application Reference...............................................................................................................................142
10.20 System Headers................................................................................................................................................143
10.20.1 SOC Properties.........................................................................................................................................144
10.20.2 Configuration Flow ....................................................................................................................................144
10.20.3 Application Reference...............................................................................................................................145
10.21 LIF and Port Profiles.........................................................................................................................................145
10.21.1 LIF Profiles................................................................................................................................................145
10.21.2 Port Profiles ..............................................................................................................................................145
10.21.3 Application Reference...............................................................................................................................146
10.22 Application Reference and Field Applications...............................................................................................146
10.22.1 Field Application Reference ......................................................................................................................146
10.22.1.1 ITMH ...............................................................................................................................................146
10.22.1.2 ITMH PPH.......................................................................................................................................147
10.22.1.3 RCH Remove..................................................................................................................................147
10.23 Diagnostics........................................................................................................................................................147
10.23.1 Field Group Diagnostics............................................................................................................................147
10.23.2 Context Diagnostics ..................................................................................................................................148
10.23.2.1 List ..................................................................................................................................................148
10.23.2.2 Detailed Info....................................................................................................................................148
10.23.3 Attach Diagnostics ....................................................................................................................................149
10.23.4 TCAM Bank Diagnostics ...........................................................................................................................150
10.23.5 TCAM Management..................................................................................................................................150
10.23.6 Entry Diagnostics ......................................................................................................................................150
10.23.6.1 List ..................................................................................................................................................150
10.23.6.2 Info..................................................................................................................................................151
10.23.6.3 FEM Diagnostic ..............................................................................................................................151
10.23.7 Qualifiers...................................................................................................................................................151
10.23.8 Actions ......................................................................................................................................................151
10.23.9 ACE Diagnostics .......................................................................................................................................152
10.23.9.1 ACE Format Diagnostics ................................................................................................................152
10.23.9.2 ACE Entries Diagnostics.................................................................................................................152
10.23.10 System Header Profiles ..........................................................................................................................152
10.23.11 EFES Diagnostics ...................................................................................................................................152
10.23.12 Field System View ..................................................................................................................................152
10.23.13 Field Last ................................................................................................................................................153
10.23.14 API Descriptions .....................................................................................................................................153
10.23.14.1 bcm_field_group_*........................................................................................................................153
10.23.14.2 bcm_field_context_* .....................................................................................................................158
10.23.14.3 bcm_field_presel_* .......................................................................................................................162
Broadcom 88690-PG107a-PUB
10
BCM88690 Programming Guide Packet Processing
10.23.14.4 bcm_field_qualifier_* ....................................................................................................................163
10.23.14.5 bcm_field_action_* .......................................................................................................................164
10.23.14.6 bcm_field_entry_* .........................................................................................................................166
10.23.14.7 bcm_field_ace_* ...........................................................................................................................169
10.23.14.8 bcm_fem_action_* ........................................................................................................................171
10.23.14.9 bcm_efes_action_* .......................................................................................................................172
10.23.14.10 bcm_field_compare_* .................................................................................................................174
10.23.14.11 bcm_field_entry_hit_* .................................................................................................................175
10.23.14.12 bcm_field_tcam_* .......................................................................................................................175
10.23.14.13 bcm_field_range_*......................................................................................................................176
10.23.14.14 bcm_field_name_* ......................................................................................................................178
10.24 Hashing Parameters ........................................................................................................................................179
10.25 Common Types .................................................................................................................................................179
10.25.1 Common Enum Supported Values ...........................................................................................................179
10.25.2 Layer Record Structure.............................................................................................................................181
10.25.2.1 General Structure ...........................................................................................................................181
10.25.3 Layer Records Qualifier Structure.............................................................................................................181
10.25.3.1 Get the Structure by SDK Code......................................................................................................181
10.25.3.2 UDP Parsing over IPv4 and IPv6 Layers........................................................................................182
10.26 Information Specific to the BCM88690 (Jericho2) Device.............................................................................183
10.26.1 CS Qualifiers.............................................................................................................................................183
10.26.2 Qualifiers List ............................................................................................................................................185
10.26.2.1 Header Qualifiers List .....................................................................................................................185
10.26.2.2 Layer Record Qualifiers List ...........................................................................................................186
10.26.2.3 Metadata Qualifiers List ..................................................................................................................187
10.26.3 Actions List................................................................................................................................................195
10.27 Information Specific to the BCM88480 (Q2A) Device ....................................................................................204
10.27.1 CS Qualifiers.............................................................................................................................................204
10.27.2 Qualifiers List ............................................................................................................................................206
10.27.2.1 Header Qualifiers List .....................................................................................................................206
10.27.2.2 Layer Record Qualifiers List ...........................................................................................................207
10.27.2.3 Metadata Qualifiers List ..................................................................................................................208
10.27.3 Actions List................................................................................................................................................216
10.28 Information Specific to the BCM88800 (Jericho2C) Device..........................................................................226
10.28.1 CS Qualifiers.............................................................................................................................................226
10.28.2 Qualifiers List ............................................................................................................................................228
10.28.2.1 Header Qualifiers List .....................................................................................................................228
10.28.2.2 Layer Record Qualifiers List ...........................................................................................................229
10.28.2.3 Metadata Qualifiers List ..................................................................................................................230
10.28.3 Actions List................................................................................................................................................238
Broadcom 88690-PG107a-PUB
11
BCM88690 Programming Guide Packet Processing
Chapter 11: Traps ...........................................................................................................................248
11.1 Introduction .........................................................................................................................................................248
11.1.1 Working with Traps .....................................................................................................................................248
11.1.1.1 Trap Code.........................................................................................................................................248
11.1.1.2 Forward and Snoop Strength............................................................................................................248
11.1.1.3 Action Resolution..............................................................................................................................248
11.1.1.4 Action Update ...................................................................................................................................248
11.1.2 Trigger Events.............................................................................................................................................249
11.2 Trap Types...........................................................................................................................................................249
11.2.1 Ingress Traps ..............................................................................................................................................250
11.2.1.1 Ingress Predefined Traps .................................................................................................................250
11.2.1.2 Ingress User-Defined Traps..............................................................................................................250
11.2.2 Egress Traps...............................................................................................................................................250
11.2.2.1 ERPP User-Defined Traps................................................................................................................251
11.2.2.2 ETPP User-Defined Traps ................................................................................................................251
11.2.2.3 ETPP OAM Traps .............................................................................................................................251
11.2.3 SOC Properties...........................................................................................................................................251
11.2.4 Shell Commands.........................................................................................................................................252
11.2.5 Application Reference.................................................................................................................................252
11.3 Trap Configuration..............................................................................................................................................252
11.3.1 Action Configuration....................................................................................................................................252
11.3.1.1 Configuration Flow............................................................................................................................253
11.3.2 Trap Action Configuration ...........................................................................................................................255
11.3.2.1 bcm_rx_trap_config_t .......................................................................................................................255
11.4 Trapping and Redirecting a Packet to the CPU................................................................................................258
11.4.1 Application Reference.................................................................................................................................259
11.5 Application Configuration..................................................................................................................................259
11.5.1 Egress Application Traps ............................................................................................................................259
11.5.1.1 ERPP Application Trap Types ..........................................................................................................259
11.5.1.2 ETPP Application Trap Types...........................................................................................................259
11.5.1.3 SOC Properties.................................................................................................................................259
11.5.1.4 Configuration Flow............................................................................................................................260
11.5.1.5 Shell Commands ..............................................................................................................................261
11.5.1.6 Application Reference.......................................................................................................................261
11.5.2 Protocol Traps.............................................................................................................................................262
11.5.2.1 SOC Properties.................................................................................................................................263
11.5.2.2 Configuration Flow............................................................................................................................263
11.5.2.3 Shell Commands ..............................................................................................................................265
11.5.2.4 Application Reference.......................................................................................................................265
11.5.3 Programmable Traps ..................................................................................................................................266
Broadcom 88690-PG107a-PUB
12
BCM88690 Programming Guide Packet Processing
11.5.3.1 SOC Properties.................................................................................................................................266
11.5.3.2 Qualifier Configuration ......................................................................................................................266
11.5.3.3 Configuration Flow............................................................................................................................268
11.5.3.4 Shell Commands ..............................................................................................................................268
11.5.3.5 Application Reference.......................................................................................................................268
11.5.4 ETPP MTU Traps........................................................................................................................................269
11.5.4.1 SOC Properties.................................................................................................................................269
11.5.4.2 Configuration Flow............................................................................................................................270
11.5.4.3 Shell Commands ..............................................................................................................................272
11.5.4.4 Application Reference.......................................................................................................................273
11.5.5 LIF Traps.....................................................................................................................................................273
11.5.5.1 SOC Properties.................................................................................................................................273
11.5.5.2 Configuration Flow............................................................................................................................273
11.5.5.3 Shell Commands ..............................................................................................................................275
11.5.5.4 Application Reference.......................................................................................................................275
11.5.6 API Descriptions .........................................................................................................................................275
11.5.6.1 bcm_rx_trap_* ..................................................................................................................................275
11.5.6.2 bcm_rx_trap_action_profile_* ...........................................................................................................277
11.5.6.3 bcm_rx_trap_protocol_*....................................................................................................................278
11.5.6.4 bcm_rx_trap_prog_* .........................................................................................................................280
11.5.6.5 bcm_rx_mtu_*...................................................................................................................................281
11.5.6.6 bcm_rx_trap_lif_*..............................................................................................................................282
11.6 Device-Specific Traps.........................................................................................................................................283
11.6.1 Trap Information Specific to the BCM88690 Device (Jericho2) ..................................................................283
11.6.1.1 Ingress Predefined Traps .................................................................................................................283
11.6.1.2 ERPP Application Traps ...................................................................................................................287
11.6.1.3 ETPP Application Traps....................................................................................................................288
11.6.2 Trap Information Specific to the BCM88800 Device (Jericho2C) ...............................................................288
11.6.2.1 Ingress Predefined Traps .................................................................................................................288
11.6.2.2 ERPP Application traps ....................................................................................................................293
11.6.2.3 ETPP Application Traps....................................................................................................................293
11.6.3 Trap Information Specific to the BCM88480 Device (Q2A) ........................................................................294
11.6.3.1 Ingress Predefined Traps .................................................................................................................294
11.6.3.2 ERPP Application Traps ...................................................................................................................298
11.6.3.3 ETPP Application Traps....................................................................................................................299
Chapter 12: Load Balancing .......................................................................................................... 300
12.1 Introduction .........................................................................................................................................................300
12.2 Application Configuration Checklist.................................................................................................................300
12.3 Speculative Parsing............................................................................................................................................300
12.3.1 SOC Properties...........................................................................................................................................301
Broadcom 88690-PG107a-PUB
13
BCM88690 Programming Guide Packet Processing
12.3.2 Configuration Flow ......................................................................................................................................301
12.3.3 Shell Commands.........................................................................................................................................301
12.3.4 Application Reference.................................................................................................................................301
12.4 Symmetrical Hashing Configuration.................................................................................................................302
12.4.1 SOC Properties...........................................................................................................................................302
12.4.2 Configuration Flow ......................................................................................................................................302
12.4.3 Shell Commands.........................................................................................................................................302
12.4.4 Application Reference.................................................................................................................................302
12.5 Bit Selection for Layer Records.........................................................................................................................303
12.5.1 SOC Properties...........................................................................................................................................303
12.5.2 Configuration Flow ......................................................................................................................................303
12.5.3 Shell Commands.........................................................................................................................................303
12.5.4 Application Reference.................................................................................................................................303
12.6 Seed Selection.....................................................................................................................................................303
12.6.1 SOC Properties...........................................................................................................................................303
12.6.2 Configuration Flow ......................................................................................................................................304
12.6.3 Shell Commands.........................................................................................................................................304
12.6.4 Application Reference.................................................................................................................................304
12.7 Assigning a CRC Function to the Load-Balancing Keys ................................................................................304
12.7.1 SOC Properties...........................................................................................................................................304
12.7.2 Configuration Flow ......................................................................................................................................305
12.7.3 Shell Commands.........................................................................................................................................305
12.7.4 Application Reference.................................................................................................................................305
12.8 Enable or Disable Header Field Usage in LB Key Generation........................................................................305
12.8.1 SOC Properties...........................................................................................................................................305
12.8.2 Configuration Flow ......................................................................................................................................306
12.8.3 Shell Commands.........................................................................................................................................306
12.8.4 Application Reference.................................................................................................................................306
Chapter 13: Protection Switching ................................................................................................. 307
13.1 Application Configuration Checklist.................................................................................................................307
13.2 Failover Object ....................................................................................................................................................307
13.2.1 SOC Properties...........................................................................................................................................308
13.2.2 Configuration Flow ......................................................................................................................................308
13.2.3 Shell Commands.........................................................................................................................................308
13.2.4 Application Reference.................................................................................................................................308
13.3 FEC 1:1 Unicast Protection................................................................................................................................309
13.3.1 Configuration Flow ......................................................................................................................................309
13.3.1.1 L2 Object: VLAN-Port 1:1 Unicast Protection ...................................................................................310
13.3.1.2 L2 Object: MPLS-Port 1:1 Unicast Protection...................................................................................310
13.3.2 Shell Commands.........................................................................................................................................311
Broadcom 88690-PG107a-PUB
14
BCM88690 Programming Guide Packet Processing
13.3.3 Application Reference.................................................................................................................................311
13.4 VLAN-Port 1+1 Protection ..................................................................................................................................311
13.4.1 SOC Properties...........................................................................................................................................311
13.4.2 Configuration Flow ......................................................................................................................................311
13.4.3 Shell Commands.........................................................................................................................................312
13.4.4 Application Reference.................................................................................................................................312
13.5 VLAN-Port 1:1 Multicast Protection ..................................................................................................................312
13.5.1 SOC Properties...........................................................................................................................................313
13.5.2 Configuration Flow ......................................................................................................................................313
13.5.3 Shell Commands.........................................................................................................................................313
13.5.4 Application Reference.................................................................................................................................313
13.6 MPLS-Port 1+1 Protection..................................................................................................................................314
13.6.1 SOC Properties...........................................................................................................................................314
13.6.2 Configuration Flow ......................................................................................................................................314
13.6.3 Shell Commands.........................................................................................................................................314
13.6.4 Application Reference.................................................................................................................................314
13.7 MPLS-Port 1:1 Multicast Protection ..................................................................................................................315
13.7.1 SOC Properties...........................................................................................................................................315
13.7.2 Configuration Flow ......................................................................................................................................315
13.7.3 Shell Commands.........................................................................................................................................315
13.7.4 Application Reference.................................................................................................................................315
13.8 MPLS Tunnel 1+1 Protection..............................................................................................................................316
13.8.1 SOC Properties...........................................................................................................................................316
13.8.2 Configuration Flow ......................................................................................................................................316
13.8.3 Shell Commands.........................................................................................................................................316
13.8.4 Application Reference.................................................................................................................................316
13.9 MPLS Tunnel 1:1 Multicast Protection..............................................................................................................317
13.9.1 SOC Properties...........................................................................................................................................317
13.9.2 Configuration Flow ......................................................................................................................................317
13.9.3 Shell Commands.........................................................................................................................................317
13.9.4 Application Reference.................................................................................................................................317
13.10 API Descriptions ...............................................................................................................................................318
Chapter 14: PP Statistics Generation ...........................................................................................319
14.1 Introduction .........................................................................................................................................................319
14.2 Application Configuration Checklist.................................................................................................................319
14.3 Egress QoS Meter Offset....................................................................................................................................319
14.3.1 SOC Properties...........................................................................................................................................319
14.3.2 Configuration Flow ......................................................................................................................................319
14.3.3 Shell Commands.........................................................................................................................................320
14.3.4 Application Reference.................................................................................................................................320
Broadcom 88690-PG107a-PUB
15
BCM88690 Programming Guide Packet Processing
14.4 Statistics PP Profile............................................................................................................................................320
14.4.1 SOC Properties...........................................................................................................................................320
14.4.2 Configuration Flow ......................................................................................................................................321
14.4.3 Application Reference.................................................................................................................................322
14.4.4 Statistics Object ..........................................................................................................................................322
14.4.5 Statistics Metadata......................................................................................................................................322
14.4.6 SOC Properties...........................................................................................................................................322
14.4.7 Configuration Flow ......................................................................................................................................322
14.4.8 Application Reference.................................................................................................................................325
14.4.9 API Descriptions .........................................................................................................................................325
Chapter 15: VLAN Editing Mechanism ......................................................................................... 326
15.1 Introduction .........................................................................................................................................................326
15.2 Application Configuration Checklist.................................................................................................................326
15.3 Tag Format Classification ..................................................................................................................................326
15.3.1 SOC Properties...........................................................................................................................................327
15.3.2 Configuration Flow ......................................................................................................................................327
15.3.3 Shell Commands.........................................................................................................................................329
15.3.4 Application Reference.................................................................................................................................329
15.4 VLAN Edit Attributes per AC-LIF .......................................................................................................................330
15.4.1 SOC Properties...........................................................................................................................................330
15.4.2 Configuration Flow ......................................................................................................................................330
15.4.3 Shell Commands.........................................................................................................................................330
15.4.4 Application Reference.................................................................................................................................330
15.5 VLAN Edit Command Mapping..........................................................................................................................331
15.5.1 SOC Properties...........................................................................................................................................331
15.5.2 Configuration Flow ......................................................................................................................................331
15.5.3 Shell Commands.........................................................................................................................................331
15.5.4 Application Reference.................................................................................................................................332
15.6 VLAN Edit Command Setting.............................................................................................................................332
15.6.1 SOC Properties...........................................................................................................................................333
15.6.2 Configuration Flow ......................................................................................................................................333
15.6.3 Shell Commands.........................................................................................................................................334
15.6.4 Application Reference.................................................................................................................................334
15.7 API Descriptions .................................................................................................................................................335
15.7.1 VLAN Tag Format Classification.................................................................................................................335
15.7.2 VLAN Edit Attributes per AC-LIF.................................................................................................................335
15.7.3 VLAN Edit Command Mapping ...................................................................................................................335
15.7.4 VLAN Edit Command Setting......................................................................................................................335
Chapter 16: Drop-and-Continue and Standardized Recycle Header ......................................... 336
Broadcom 88690-PG107a-PUB
16
BCM88690 Programming Guide Packet Processing
16.1 Introduction .........................................................................................................................................................336
16.1.1 Drop-and-Continue .....................................................................................................................................336
16.2 Drop-and-Continue Configuration Checklist....................................................................................................337
16.3 Recycle Port ........................................................................................................................................................337
16.3.1 SOC Properties...........................................................................................................................................337
16.3.2 Configuration Flow ......................................................................................................................................337
16.3.3 Shell Commands.........................................................................................................................................338
16.4 Encapsulation Recycle Entry.............................................................................................................................338
16.4.1 SOC Properties...........................................................................................................................................338
16.4.2 Configuration Flow ......................................................................................................................................338
16.4.3 Shell Commands.........................................................................................................................................339
16.5 Configuring Second-Pass Tunnel Termination................................................................................................339
16.5.1 SOC Properties...........................................................................................................................................339
16.5.2 Configuration Flow ......................................................................................................................................339
16.5.3 Shell Commands.........................................................................................................................................339
16.5.4 Application Reference.................................................................................................................................340
16.6 API Descriptions .................................................................................................................................................340
16.6.1 IP Tunnel Termination Object .....................................................................................................................340
16.6.2 MPLS Tunnel Termination Object ...............................................................................................................340
16.6.3 Recycle Entry..............................................................................................................................................340
16.6.4 Recycle Port................................................................................................................................................340
Chapter 17: ROO (Routing Over Overlay) .................................................................................... 341
17.1 Introduction .........................................................................................................................................................341
17.2 Application Configuration Checklist.................................................................................................................342
17.3 Native L3 Egress Object: Egress-ARP (Next-Hop)...........................................................................................342
17.3.1 SOC Properties...........................................................................................................................................342
17.3.2 Configuration Flow ......................................................................................................................................342
17.3.3 Shell Commands.........................................................................................................................................342
17.4 Native L3 Egress Object: Ingress-FEC..............................................................................................................343
Chapter 18: L2 Generalized Bridging Model ................................................................................ 344
18.1 Introduction .........................................................................................................................................................344
18.2 Split Horizon (Network Groups).........................................................................................................................344
18.2.1 Application Configuration Checklist ............................................................................................................345
18.2.2 SOC Properties...........................................................................................................................................345
18.2.3 Define Orientation-Based Filtering..............................................................................................................345
18.2.4 Configure Split Horizon for Egress L2 VPN Tunnels (PWE, VXLAN, EVPN) .............................................345
18.2.5 Configuration Flow ......................................................................................................................................345
18.2.6 Shell Commands.........................................................................................................................................346
18.2.7 Application Reference.................................................................................................................................347
Broadcom 88690-PG107a-PUB
17
BCM88690 Programming Guide Packet Processing
18.3 Cross-Connect ....................................................................................................................................................347
18.3.1 Configuration Flow ......................................................................................................................................347
18.3.2 Shell Commands.........................................................................................................................................348
18.3.3 Application Reference.................................................................................................................................348
18.4 API Descriptions .................................................................................................................................................348
18.4.1 Split Horizon................................................................................................................................................348
18.4.2 Cross Connect ............................................................................................................................................348
18.5 Gport Forward Information ................................................................................................................................349
18.5.1 Configuration Flow ......................................................................................................................................349
18.5.2 Shell Commands.........................................................................................................................................349
18.5.3 API Descriptions .........................................................................................................................................349
Chapter 19: Ethernet Bridge .......................................................................................................... 350
19.1 Introduction .........................................................................................................................................................350
19.2 Application Configuration Checklist.................................................................................................................350
19.3 TPID Definitions ..................................................................................................................................................351
19.3.1 SOC Properties...........................................................................................................................................351
19.3.2 Configuration Flow ......................................................................................................................................351
19.3.3 Shell Commands.........................................................................................................................................351
19.3.4 Application Reference.................................................................................................................................351
19.4 Port Bridging Properties ....................................................................................................................................352
19.4.1 SOC Properties...........................................................................................................................................352
19.4.2 Configuration Flow ......................................................................................................................................353
19.4.3 Shell Commands.........................................................................................................................................354
19.4.4 Application Reference.................................................................................................................................354
19.5 Port x VLAN Properties ......................................................................................................................................355
19.5.1 SOC Properties...........................................................................................................................................355
19.5.2 Configuration Flow ......................................................................................................................................355
19.5.3 Shell Commands.........................................................................................................................................355
19.5.4 Application Reference.................................................................................................................................356
19.6 Port x VLAN-Tag-Structure Configuration........................................................................................................356
19.6.1 SOC Properties...........................................................................................................................................356
19.6.2 Configuration Flow ......................................................................................................................................357
19.6.3 Shell Commands.........................................................................................................................................358
19.6.4 Application Reference.................................................................................................................................358
19.7 VLAN-Translation AC-LIF...................................................................................................................................360
19.7.1 SOC Properties...........................................................................................................................................362
19.7.2 Configuration Flow ......................................................................................................................................362
19.7.2.1 Ingress AC-LIF VLAN Translation ....................................................................................................362
19.7.2.2 Egress AC-LIF VLAN Translation .....................................................................................................364
19.7.2.3 Additional Match Criteria...................................................................................................................365
Broadcom 88690-PG107a-PUB
18
BCM88690 Programming Guide Packet Processing
19.7.3 Shell Commands.........................................................................................................................................366
19.7.4 Application Reference.................................................................................................................................367
19.8 VSI Ethernet Bridging Properties ......................................................................................................................367
19.8.1 SOC Properties...........................................................................................................................................367
19.8.2 Configuration Flow ......................................................................................................................................368
19.8.3 Shell Commands.........................................................................................................................................368
19.8.4 Application Reference.................................................................................................................................369
19.9 MACT Management: Aging ................................................................................................................................369
19.9.1 SOC Properties...........................................................................................................................................369
19.9.2 Configuration Flow ......................................................................................................................................369
19.9.3 Shell Commands.........................................................................................................................................370
19.9.4 Application Reference.................................................................................................................................370
19.10 MACT Management: Flush Machine................................................................................................................370
19.10.1 SOC Properties.........................................................................................................................................370
19.10.2 Configuration Flow ....................................................................................................................................370
19.10.3 Shell Commands.......................................................................................................................................374
19.10.4 Application Reference...............................................................................................................................374
19.11 MACT Management: L2 Learn..........................................................................................................................374
19.11.1 SOC Properties.........................................................................................................................................375
19.11.2 Configuration Flow ....................................................................................................................................375
19.11.3 Shell Commands.......................................................................................................................................378
19.11.4 Application Reference...............................................................................................................................378
19.12 MACT Management: Registration upon MACT Changes ..............................................................................379
19.12.1 SOC Properties.........................................................................................................................................379
19.12.2 Configuration Flow ....................................................................................................................................379
19.12.3 Shell Commands.......................................................................................................................................379
19.12.4 Application Reference...............................................................................................................................379
19.13 L2 MACT Forwarding........................................................................................................................................380
19.13.1 SOC Properties.........................................................................................................................................380
19.13.2 Configuration Flow ....................................................................................................................................380
19.13.3 Shell Commands.......................................................................................................................................382
19.13.4 Application Reference...............................................................................................................................382
19.14 STG Properties..................................................................................................................................................382
19.14.1 SOC Properties.........................................................................................................................................382
19.14.2 Configuration Flow ....................................................................................................................................383
19.14.3 Shell Commands.......................................................................................................................................383
19.14.4 Application Reference...............................................................................................................................384
19.15 L2 Filters ............................................................................................................................................................384
19.15.1 SOC Properties.........................................................................................................................................385
19.15.2 Configuration Flow ....................................................................................................................................385
Broadcom 88690-PG107a-PUB
19
BCM88690 Programming Guide Packet Processing
19.15.3 Shell Commands.......................................................................................................................................385
19.16 In-AC Wide Data ................................................................................................................................................385
19.16.1 SOC Properties.........................................................................................................................................386
19.16.2 Configuration Flow ....................................................................................................................................386
19.16.3 Shell Commands.......................................................................................................................................386
19.16.4 Application Reference...............................................................................................................................386
19.17 VLAN Compression ..........................................................................................................................................387
19.17.1 SOC Properties.........................................................................................................................................387
19.17.2 Configuration Flow ....................................................................................................................................387
19.17.3 Shell Commands.......................................................................................................................................387
19.17.4 Application Reference...............................................................................................................................387
19.18 API Descriptions ...............................................................................................................................................388
19.18.1 TPID Definitions (bcm_switch_tpid_*).......................................................................................................388
19.18.2 Port Bridging Properties............................................................................................................................388
19.18.3 Port x VLAN Properties.............................................................................................................................388
19.18.4 Port x VLAN-Tag-Structure .......................................................................................................................389
19.18.5 In-AC Wide Data .......................................................................................................................................389
19.18.6 AC VLAN Translation................................................................................................................................389
19.18.7 VSI Ethernet Bridging Properties ..............................................................................................................390
19.18.8 MACT Management: Aging.......................................................................................................................390
19.18.9 MACT Management: Flush Machine ........................................................................................................391
19.18.10 MACT Management: L2 Learn................................................................................................................391
19.18.11 MACT Management: Registration upon MACT Changes .......................................................................391
19.18.12 L2 MACT Forwarding ..............................................................................................................................392
19.18.13 STG.........................................................................................................................................................392
19.18.14 VLAN Compression ................................................................................................................................392
Chapter 20: IP Router ..................................................................................................................... 393
20.1 Introduction .........................................................................................................................................................393
20.2 Application Configuration Checklist.................................................................................................................393
20.3 Port Routing Properties......................................................................................................................................394
20.3.1 SOC Properties...........................................................................................................................................394
20.3.2 Configuration Flow ......................................................................................................................................394
20.3.3 Shell Commands.........................................................................................................................................394
20.3.4 Application Reference.................................................................................................................................394
20.4 My-MAC Layer 2 Termination.............................................................................................................................395
20.4.1 SOC Properties...........................................................................................................................................395
20.4.2 Configuration Flow ......................................................................................................................................395
20.4.3 Shell Commands.........................................................................................................................................395
20.4.4 Application Reference.................................................................................................................................395
20.5 My-MAC Enhancements (VRRP and Multiple My-MAC) ..................................................................................395
Broadcom 88690-PG107a-PUB
20
BCM88690 Programming Guide Packet Processing
20.5.1 My-MAC Based on VSI Table and TCAM...................................................................................................395
20.5.2 My-MAC Based on EXEM...........................................................................................................................396
20.5.3 SOC Properties...........................................................................................................................................396
20.5.4 Configuration Flow ......................................................................................................................................397
20.5.4.1 My-MAC Based on TCAM+VSI.........................................................................................................397
20.5.4.2 My-MAC Based on EXEM ................................................................................................................398
20.5.5 Shell Commands.........................................................................................................................................398
20.5.6 Application Reference.................................................................................................................................399
20.6 ETH-RIF (L3 VSI Interface) and VRF Definition ................................................................................................399
20.6.1 SOC Properties...........................................................................................................................................400
20.6.2 Configuration Flow ......................................................................................................................................400
20.6.3 Shell Commands.........................................................................................................................................402
20.6.4 Application Reference.................................................................................................................................402
20.7 L3 Egress Object: Egress-ARP (Next-Hop) ......................................................................................................403
20.7.1 SOC Properties...........................................................................................................................................403
20.7.2 Configuration Flow ......................................................................................................................................404
20.7.3 Shell Commands.........................................................................................................................................405
20.7.4 Application Reference.................................................................................................................................405
20.8 L3 Egress Object: Ingress-FEC .........................................................................................................................405
20.8.1 SOC Properties...........................................................................................................................................406
20.8.2 Configuration Flow ......................................................................................................................................406
20.8.3 Shell Commands.........................................................................................................................................408
20.8.4 Application Reference.................................................................................................................................408
20.9 L3 Egress Object: Protection-FEC ....................................................................................................................408
20.10 L3 Egress: ECMP Object ..................................................................................................................................408
20.10.1 SOC Properties.........................................................................................................................................409
20.10.2 Configuration Flow ....................................................................................................................................410
20.10.3 Shell Commands.......................................................................................................................................410
20.10.4 Application Reference...............................................................................................................................411
20.11 Adding Route Entries .......................................................................................................................................411
20.11.1 Traverse Route .........................................................................................................................................411
20.11.2 Default Route ............................................................................................................................................411
20.11.3 Route Hit Bits ............................................................................................................................................411
20.11.4 SOC Properties.........................................................................................................................................411
20.11.5 Configuration Flow ....................................................................................................................................412
20.11.6 Shell Commands.......................................................................................................................................413
20.11.7 Application Reference...............................................................................................................................413
20.12 Adding IPMC Entries.........................................................................................................................................413
20.12.1 IPv4 MC Flow ...........................................................................................................................................413
20.12.1.1 L3 Flow ...........................................................................................................................................414
/