API Guide

Table Of Contents
Version Description
8.3.7.0 Introduced on the S4810.
8.1.1.0 Introduced on the E-Series ExaScale.
7.6.1.0 Introduced on the S-Series.
7.5.1.0 Introduced on the C-Series.
7.4.1.0 Added the monitor option.
6.1.1.0 Introduced on the E-Series.
Usage Information
When you use the log option, the CP processor logs detail the packets that match. Depending on how many
packets match the log entry and at what rate, the CP may become busy as it has to log these packet details.
By default, 10 ACL logs are generated if you do not specify the threshold explicitly. The default frequency at which
ACL logs are generated is five minutes. By default, flow-based monitoring is not enabled.
Use the monitor option only when you are using flow-based monitoring. For more information, refer to the Port
Monitoring chapter in the C9000 Series Configuration Guide.
NOTE: When ACL logging and byte counters are configured simultaneously, byte counters may
display an incorrect value. Configure packet counters with logging instead.
Related
Commands
deny — configures a MAC ACL filter to drop packets.
seq — configure a MAC ACL filter with a specified sequence number.
seq
Configure a filter with a specific sequence number.
C9000 Series
Syntax
seq sequence-number {deny | permit} {any | host mac-address | mac-source-
address mac-source-address-mask} {any | host mac-address | mac-destination-
address mac-destination-address-mask} [ethertype operator] [count [byte]] [log
[interval minutes] [threshold-in-msgs [count]] [monitor]
To delete a filter, use the no seq sequence-number command.
Parameters
sequence-number
Enter a number as the filter sequence number. The range is from zero (0) to 65535.
deny Enter the keyword deny to drop any traffic matching this filter.
permit Enter the keyword permit to forward any traffic matching this filter.
any Enter the keyword any to filter all packets.
host
mac-address
Enter the keyword host and then enter a MAC address to filter packets with that host
address.
mac-source-
address
Enter a MAC address in nn:nn:nn:nn:nn:nn format.
The MAC ACL supports an inverse mask; therefore, a mask of ff:ff:ff:ff:ff:ff allows entries
that do not match and a mask of 00:00:00:00:00:00 only allows entries that match
exactly.
mac-source-
address-mask
Specify which bits in the MAC address must be matched.
mac-destination-
address
Enter the destination MAC address and mask in nn:nn:nn:nn:nn:nn format.
mac-destination-
address-mask
Specify which bits in the MAC address must be matched.
268 Access Control Lists (ACL)