To display all IPv6 access-control lists (ACLs) or a specific IPv6
ACL, use the
show
ipv6
access-lists
command.
show ipv6 access-lists [access-list-name] [expanded | summary]
Syntax Description
access-list-name
|
(Optional) Name of an IPv6 ACL, which can be up to 64
alphanumeric, case-sensitive characters.
|
expanded
|
(Optional) Specifies that the contents of IPv6 address
groups or port groups show rather than the names of object groups only.
|
summary
|
(Optional) Specifies that the command displays information
about the ACL rather than the ACL configuration. For more information, see the
“Usage Guidelines” section.
|
Command Modes
Any command mode
Command History
Release
|
Modification
|
4.2(1)
|
Command output is sorted alphabetically by the ACL names.
Support was added for the
fragments command.
|
4.1(2)
|
This command was introduced.
|
Usage Guidelines
The device shows all IPv6 ACLs, unless you use the
access-list-name argument to specify an ACL.
If you do not specify an ACL name, the device lists ACLs
alphabetically by the ACL names.
IPv6 address object groups and IP port object groups show only by
name, unless you use the
expanded keyword.
The
expanded keyword allows you to display the
details of object groups used in an ACL rather than only the name of the object
groups. For more information about object groups, see the
object-group
ipv6
address and
object-group
ip
port commands.
The
summary keyword allows you to display
information about the ACL rather than the ACL configuration. The information
displayed includes the following:
- Whether per-entry statistics are configured for the ACL.
- Whether the
fragments command is configured for the
ACL.
- The number of rules in the ACL configuration. This number does not
reflect how many entries that the ACL contains when the device applies it to an
interface. If a rule in the ACL uses an object group, the number of entries in
the ACL when it is applied may be much greater than the number of rules.
- The interfaces that the ACL is applied to.
- The interfaces that the ACL is active on.
The
show
ipv6
access-lists command displays statistics for each
entry in an ACL if the following conditions are both true:
- The ACL configuration contains the
statistics
per-entry command.
- The ACL is applied to an interface that is administratively up.
If an IP ACL includes the
fragments command, it appears before the
explicit permit and deny rules, but the device applies the
fragments command to noninitial fragments
only if they do not match all other explicit rules in the ACL.
This command does not require a license.
Examples
This example shows how to use the
show
ipv6
access-lists command to display all IPv6 ACLs on a
device that has a single IPv6 ACL:
switch# show ipv6 access-lists
IPv6 access list ipv6-main-filter
10 permit ipv6 any any
This example shows how to use the
show
ipv6
access-lists command to display an IPv6 ACL named
ipv6-RandD-outbound-web, including per-entry statistics for the entries except
for the LowerLab object group:
switch# show ipv6 access-lists ipv6-RandD-outbound-web
IPv6 access list ipv6-RandD-outbound-web
statistics per-entry
fragments deny-all
1000 permit ahp any any [match=732]
1005 permit tcp addrgroup LowerLab any eq telnet
1010 permit tcp any any eq www [match=820421]
This example shows how to use the
show
ipv6
access-lists command to display an IPv6 ACL named
ipv6-RandD-outbound-web. The
expanded keyword causes the contents of the
object group from the previous example to appear, including the per-entry
statistics:
switch# show ipv6 access-lists ipv6-RandD-outbound-web expanded
IPv6 access list ipv6-RandD-outbound-web
statistics per-entry
1000 permit ahp any any [match=732]
1005 permit tcp 2001:db8:0:3ab0::1/128 any eq telnet [match=5032]
1005 permit tcp 2001:db8:0:3ab0::32/128 any eq telnet [match=433]
1010 permit tcp any any eq www [match=820421]
This example shows how to use the
show
ipv6
access-lists command with the
summary keyword to display information about
an IPv6 ACL named ipv6-RandD-outbound-web, such as which interfaces the ACL is
applied to and active on:
switch# show ipv6 access-lists ipv6-RandD-outbound-web summary
IPV6 ACL ipv6-RandD-outbound-web
Statistics enabled
Total ACEs Configured: 4
Configured on interfaces:
Ethernet2/4 - ingress (Router ACL)
Active on interfaces:
Ethernet2/4 - ingress (Router ACL)