configure protocol filter

configure protocol filter filter_name [add | delete] dest-mac mac_address {[etype | llc | snap] hex} {field offset offset value value {mask mask}}

Description

Configures the destination address as well as an arbitrary field of the protocol.

Syntax Description

filter_name Specifies a protocol filter name.
add Specifies that you add a protocol.
delete Specifies that you delete a protocol.
dest-mac Specifies the destination MAC address used by PDUs of the protocol.
mac_address Specifies the MAC address.
etype Specifies the EtherType used by PDUs of the protocol.
llc Specifies the LLC DSAP and SSAP used by PDUs of the protocol.
snap Specifies the SNAP protocol identifier used by PDUs of the protocol.
hex Specifies a four-digit hexadecimal number between 0 and FFFF that represents:
  • The Ethernet protocol type taken from a list maintained by the IEEE.
  • The DSAP/SSAP combination created by concatenating a two-digit LLC Destination SAP (DSAP) and a two-digit LLC Source SAP (SSAP).
  • The SNAP-encoded Ethernet protocol type.
field Specifies a field used by PDUs of the protocol.
offset Specifies the offset of the field from the start of the PDU.
value value Specifies the value of the field in hexadecimal (for example, A1:B2:0C. Maximum 16 bytes).
mask mask Specifies the mask for the field in hexadecimal (for example, FF:FF:0F. Maximum 16 bytes).

Default

N/A.

Usage Guidelines

Supported protocol types include:

  • etype—IEEE Ethertype.
  • llc—LLC Service Advertising Protocol.
  • snap—Ethertype inside an IEEE SNAP packet encapsulation.

A maximum of 15 protocol filters, each containing a maximum of six protocols, can be defined.

The protocol filter must already exist before you can use this command. Use the create protocol command to create the protocol filter.

No more than seven protocols can be active and configured for use.

Note

Note

Protocol-based VLAN (Virtual LAN) for Etype from 0x0000 to 0x05ff are not classifying as per filter. When traffic arrive with these Etypes, it is classifed to native VLAN rather protocol-based VLAN.

Example

The following example LACP to the protocol list "mylist":

configure protocol “mylist” add dest-mac 01:80:C2:00:00:02 etype 0x8809 field offset 14 value 
01 mask FF

The following example removes EFM OAM from the protocol list "mylist":

configure protocol filter “mylist” delete dest-mac 01:80:C2:00:00:02 etype 0x8809 field offset 
14 value 03 mask FF

The following example configures a mismatched mask and value:

configure protocol “mylist” delete dest-mac 01:80:C2:00:00:02 etype 0x8809 field offset 14 value 03 mask FF:FF
Error: The length of the field value is not the same as the field mask.

History

This command was first available in ExtremeXOS 15.5.

Platform Availability

This command is available on the Summit X450-G2, X460-G2, X670-G2, X770, and ExtremeSwitching X440-G2, X620, X690, X870 series switches.