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}} {tagged}

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).
tagged	Specifies if the protocol is a tagged protocol. Default is not tagged.

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

Protocol-based This command is available on the ExtremeSwitching X440-G2, X450-G2, X460-G2, X465, X590, X620, X670-G2, X690, X695, X870, 5320, 5420, 5520 series switches. 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 than 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.

The tagged keyword was added in ExtremeXOS 31.4.

Platform Availability

This command is available on ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, X670-G2, X690, X695, X870, 5320, 5420, and 5520 series switches.