136
| Command Line Reference | SmartNA-X 1G/10G Modular
SmartNA-X
™
1G/10G User Guide 1.4
©
2015 Network Critical Solutions Limited
set filter arp
Use the
set filter arp
command to create filters for packets that match packets of ether-type ARP. The filter may be
further refined by specifying ARP layer 2 and/or layer 3 headers, plus any user pre-defined custom fields within the ARP
scope.
Syntax
set filter
filter-name
ARP
[
VLAN
tag
] [
PCP
level
] [
MAC
src
mac-id
] [
MAC
dest
mac-id
] [
MAC
either
mac-id
]
[
Address
src
ip
] [
Address
dest
ip
] [
Address
either
ip
] [
Customfield
custom-field-name
value
]
Parameters
filter-name
Specify a unique, case-sensitive, name for the filter. The name may contain spaces, but if it does it must be
contained in quotes "..." (the name cannot itself contain quotes).
VLAN
tag
Filter by Virtual LAN (VLAN) tag. Use one of the following formats to specify a single or multiple tags:
•
100
single tag
•
100–110
inclusive tag range
•
0/1
a value/mask tag pair (here all even tags)
•
100,150
several tags (use commas to separate values, no spaces)
PCP
level
Filter by Priority Code Point (user priority) from a VLAN header.
You may use the following formats when specifying levels:
• 2—A single level
• 2-4—An inclusive range
• 0/1—A value/mask pair (here all even)
• 0,2—Multiple levels (use commas to separate values, no spaces)
MAC
src
,
dest
,
either
mac-id
Filter by MAC address source, destination, or either. Use one of the following formats to
specify a single MAC address or multiple MAC addresses:
•
01:23:45:67:89:ab
•
01:23:45:67:89:ab,01:23:45:67:89:ac
(use commas to separate values, no spaces)
Address
src
,
dest
,
either
ipv4-address
Filter by IPv4 address. You may give either a single specification, to find packets
where either the source or the destination address matches, or separate specifications for source and/or destination address.
The following address formats are recognised:
• 192.168.0.1—A single address
• 192.168.0.4-10—An inclusive range
• 192.168.0.*—Wildcard (192.168.0.0-255)
• 10.10.0.0/255.255.255.252—Mask (10.10.0.0-3)
• 10.10.0.3,10.10.0.5—Multiple addresses (use commas to separate values, no spaces). Ranges and wildcards may be
used in any segment(s). Multiple addresses may each use either ranges and wildcards or a mask.
For ARP packets, use source for the sender address and destination for the target address.
Customfield
custom-field-name
value
Filter by custom field if a compatible field has been defined. The value entered
here must be within the scope of the field length defined for the custom field. For example, if the custom field was defined
with an 8-bit length, then values of 0-255 are permitted.
Examples
Define a filter that matches ARP packets from sources on subnet 10.10.0.* to Mac destinations 01:23:45:67:89:ab or
01:23:45:67:89:ac. Review and commit to the system.
CONTROLLER>
set filter "Example filter" arp address src 10.10.0.* mac dest
01:23:45:67:89:ab,01:23:45:67:89:ac
CONTROLLER>
show filters