OcNOS-SP : System Management Guide : System Management Command Reference : System Configure Mode Commands : show hardware-profile filters
show hardware-profile filters
Use this command to show details of TCAM filter groups which are enabled. By default, all filter groups are disabled.
Command Syntax
show hardware-profile filters
Parameter
None
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 3.0.
Examples
#show hardware-profile filters
 
Note: Shared count is the calculated number from available resources.
Dedicated count provides allocated resource to the group.
If group shares the dedicated resource with other groups, then dedicated
count of group will reduce with every resource usage by other groups.
 
+--------------------+---------+---------------+----------------------------+
| | Free | Used | Total Entries |
| TCAMS | Entries |---------------|----------------------------|
| | | % | Entries | Total | Dedicated | shared |
+--------------------+---------+-----+---------+-------+-----------+--------+
INGRESS-QOS-EXT 10495 0 1 10486 2048 8448
 
Table 34-103 explains the output fields.
 
Table 34-103: show hardware-profile filters 
Field
Description
Ingress
Ingress filtering is a method used to prevent suspicious traffic from entering a network.
TCAMS
Number of ternary content addressable memory (TCAM) entries a particular firewall filter.
Free Entries
Number of TCAM filter entries available for use by the filter group.
Used Entries
Number of TCAM filter entries used by the filter group.
Total Entries
Number of TCAM total filter entries to the filter group.
Dedicated Entries
Number of TCAM filter entries dedicated to the filter group.
Shared Entries
Number of TCAM filter entries shared to the filter groups.
Operational details of TCAM profiles
TCAM group statistics comprises of three parts:
Total Entries – Total configurable entries on the TCAM group. Total has two parts. One is dedicated and other is shared. Dedicated count is the guaranteed entry count for the group. Shared count a logical count calculated for the group from shared pool available at the time of show command execution
Used Entries – Count of entries that have been configured on the TCAM group. Used entries are shown are shown in percentage format as well as an indication of how much TCAM space is used up. However, percentage calculation includes shared pool and subject to change drastically when shared pool is taken up by different group.
Free Entries – Count of possible remaining entries on the TCAM group. Free entries count is not the guaranteed count as the count includes the shared pool count into account.
When a TCAM group is enabled in the device, no hardware resource (bank) is associated with the group. Thus, dedicated count will be initially zero. Total count will be same as shared count which is calculated based on the group width. Group width is determined by width consumed by the qualifiers or width consumed by the actions.
Example of show output when qos-ext group is enabled on QMX device is shown below:
#show hardware-profile filters
...
+--------------------+---------+---------------+----------------------------+
| | Free | Used | Total Entries |
| TCAMS | Entries |---------------|----------------------------|
| | | % | Entries | Total | Dedicated | shared |
+--------------------+---------+-----+---------+-------+-----------+--------+
INGRESS-QOS-EXT 10496 0 0 10496 0 10496
When an entry is created on the group for the first time, either a single bank or a bank pair is allocated to the group. A group consuming single bank or a bank pair is decided by group width. Groups like qos, ingress-l2, and ingress-ipv4 consume single bank and groups like qos-ext, qos-policer, ingress-l2-ext, ingress-ipv4-ext, ingress-ipv4-qos, ingress-ipv6, ingress-ipv6-qos, egress-l2, and egress-ipv4 consume a bank pair.
An example of output when a single entry is created in hardware for qos-ext group on QMX device is shown below:
#show hardware-profile filters
...
+--------------------+---------+---------------+----------------------------+
| | Free | Used | Total Entries |
| TCAMS | Entries |---------------|----------------------------|
| | | % | Entries | Total | Dedicated | shared |
+--------------------+---------+-----+---------+-------+-----------+--------+
INGRESS-QOS-EXT 10495 0 1 10496 2048 8448
In the above example, dedicated entry count has increased to 2048 as a bank pair is allocated for the group. Unallocated banks capacity is calculated for qos-ext group and counted under shared entries as 8448.
An example of output when 2048 entries are created in hardware for qos-ext group and ingress-l2 and ingress-ipv4-ext groups is enabled with no entries created on those groups for QMX device is shown below:
#show hardware-profile filters
...
+--------------------+---------+---------------+----------------------------+
| | Free | Used | Total Entries |
| TCAMS | Entries |---------------|----------------------------|
| | | % | Entries | Total | Dedicated | shared |
+--------------------+---------+-----+---------+-------+-----------+--------+
INGRESS-QOS-EXT 8448 20 2048 10496 2048 8448
INGRESS L2 16896 0 0 16896 0 16896
INGRESS IPV4-EXT 8448 0 0 8448 0 8448
In the above example, note that the number of entries between ingress-l2 and ingress-ipv4-ext groups vary as ingress-l2 group is a 160-bit wide group consuming only one bank at a time. On the other hand, ingress-ipv4-ext group is 320 bit wide group consuming a group pair at a time. With a bank pair already being consumed by qos-ext group, ingress-ipv4-ext group gets possible total entries of 8448 in comparison to 10496 by qos-ext group.
When all the created entry count goes beyond the entries of dedicated bank pair (or a bank), group will be allocated with another bank pair (or a bank) and subsequently shared pool count will reduce across all other groups.
An example of output when 2049 entries are created in hardware for qos-ext group with ingress-l2 and ingress-ipv4-ext groups enabled with no entries created on those groups for QMX device is shown below:
#show hardware-profile filters
...
+--------------------+---------+---------------+----------------------------+
| | Free | Used | Total Entries |
| TCAMS | Entries |---------------|----------------------------|
| | | % | Entries | Total | Dedicated | shared |
+--------------------+---------+-----+---------+-------+-----------+--------+
INGRESS-QOS-EXT 8447 20 2049 10496 4096 6400
INGRESS L2 12800 0 0 12800 0 12800
INGRESS IPV4-EXT 6400 0 0 6400 0 6400
When a bank is consumed by ingress-l2 group, effect on qos-ext group will still be the count of a bank pair with one bank not usable for qos-ext group even if it is available. The bank can be used by groups which consume single bank.
An example of output when an entry is created in hardware for ingress-l2 group with qos-ext and ingress-ipv4-ext groups in the state as mentioned in above example is shown below:
#show hardware-profile filters
...
+--------------------+---------+---------------+----------------------------+
| | Free | Used | Total Entries |
| TCAMS | Entries |---------------|----------------------------|
| | | % | Entries | Total | Dedicated | shared |
+--------------------+---------+-----+---------+-------+-----------+--------+
INGRESS-QOS-EXT 6399 24 2049 8448 4096 4352
INGRESS L2 12799 0 1 12800 2048 10752
INGRESS IPV4-EXT 4352 0 0 4352 0 4352
In the above example scenario, it can be noted that the used entry percentage for qos-ext group jumped from 20 to 24 as a result of drastic reduction in total entry count due to bank movement from shared pool to dedicated bank.
Hardware doesn’t optimize the utilization of banks when entries are removed from one of the banks resulting in entries used shown up less than capacity of one bank but still multiple banks would be dedicated to a group.
An extended example of above scenario with 10 entries removed from qos-ext group is shown below:
#show hardware-profile filters
...
+--------------------+---------+---------------+----------------------------+
| | Free | Used | Total Entries |
| TCAMS | Entries |---------------|----------------------------|
| | | % | Entries | Total | Dedicated | shared |
+--------------------+---------+-----+---------+-------+-----------+--------+
INGRESS-QOS-EXT 6409 24 2039 8448 4096 4352
INGRESS L2 12799 0 1 12800 2048 10752
INGRESS IPV4-EXT 4352 0 0 4352 0 4352
It can be noted that the used entry count has come down to 2039 which is less than the capacity of bank pair i.e. 2048. However, since entries are used up across two set of bank pairs, both bank pairs will still be dedicated. If there is a need to recover bank pair from dedicated pool, all the entries should be deleted and re-created in hardware.
TCAM groups are further divided into sub-categories which can share the dedicated banks between the groups. TCAM groups such as ingress-l2, ingress-l2-ext, ingress-ipv4, ingress-ipv4-ext, ingress-ipv4-qos, qos, qos-ext, qos-policer are considered under default sub-category and don't serve IPv6 traffic. TCAM groups such as ingress-ipv6, ingress-ipv6-qos, and qos-ipv6 are meant for IPv6 traffic and are considered under IPv6 sub-category.
Only four 320-bit wide groups that belong to same sub-category can be created. For default sub-category, number is limited to three as system group will be created by default.
When three default sub-category groups are created along with one group from IPv6 sub-category, one of the default sub-category group will share the bank pair with IPv6 group. This will result in dedicated count to be shown lesser by the number that the other shared group is consuming. With every single resource consumed by one group will reduce the same number from other shared group.
An example of above scenario is shown below:
#show hardware-profile filters
...
+--------------------+---------+---------------+----------------------------+
| | Free | Used | Total Entries |
| TCAMS | Entries |---------------|----------------------------|
| | | % | Entries | Total | Dedicated | shared |
+--------------------+---------+-----+---------+-------+-----------+--------+
QOS-EXT 6399 0 1 6400 2048 4352
INGRESS IPV4-ACL-EXT 6398 0 2 6400 2048 4352
INGRESS IPV4-QOS 6382 0 1 6383 2031 4352
INGRESS IPV6-ACL 6382 0 17 6399 2047 4352
Note that ingress-ipv4-qos group has shared the resource with ingress-ipv6 group. TCAM group ingress-ipv4-qos has consumed 1 entry and ingress-ipv6 group has consumed 17 entries. Hence, dedicated count for ingress-ipv4-qos group is shown as 2031 (2048 - 17) and dedicated count for ingress-ipv6 group is shown as 2047 (2048 - 1).
Capacity of TCAM profiles
Entries created on other TCAM groups affect the capacity of a particular TCAM group. This dependency is explained in the section Operational details of TCAM profiles.
In this section maximum configurable entries per group when no entries created on other groups are listed below.
 
Table 34-104: Maximum configurable entries 
TCAM Groups
QMX
QAX
QUX
ingress-l2
20992 (2048 x 10 + 256 x 2)
9728 (1024 x 9 + 256 x 2)
3584
ingress-l2-ext
10496 (2048 x 5 + 256 x 1)
4352 (1024 x 4 +256 x 1)
1792
ingress-ipv4
20992 (2048 x 10 + 256 x 2)
9728 (1024 x 9 + 256 x 2)
3584
ingress-ipv4-ext
10496 (2048 x 5 + 256 x 1)
4352 (1024 x 4 + 256 x 1)
1792
ingress-ipv4-qos
10496 (2048 x 5 + 256 x 1)
4352 (1024 x 4 + 256 x 1)
1792
ingress-ipv6
10496 (2048 x 5 + 256 x 1)
4352 (1024 x 4 + 256 x 1)
1792
ingress-ipv6-ext
10496 (2048 x 5 + 256 x 1)
4352 (1024 x 4 + 256 x 1)
1792
ingress-ipv6-ext-vlan
10496 (2048 x 5 + 256 x 1)
4352 (1024 x 4 + 256 x 1)
1792
ingress-ipv6-qos
10496 (2048 x 5 + 256 x 1)
4352 (1024 x 4 + 256 x 1)
1792
qos-ipv6
12288 (2048 x 6)
5120 (1024 x 5)
1792
qos
20992 (2048 x 10 + 256 x 2)
9728 (1024 x 9 + 256 x 2)
3584
qos-ext
10496 (2048 x 5 + 256 x 1)
4352 (1024 x 4 + 256 x 1)
1792
qos-policer
10496 (2048 x 5 + 256 x 1)
4352 (1024 x 4 + 256 x 1)
1792
egress-l2
10496 (2048 x 5 + 256 x 1)
4352 (1024 x 4 + 256 x 1)
1792
egress-ipv4
10496 (2048 x 5 + 256 x 1)
4352 (1024 x 4 + 256 x 1)
1792
cfm-domain-name-str
20992 (2048 x 10 + 256 x 2)
9728 (1024 x 9 + 256 x 2)
3584
Combination of TCAM profiles
Device supports configuration of only one egress group in the system. Hence out of the egress groups cfm-domain-name-str, egress-l2 and egress-ipv4, only one egress group can be enabled.
In other words, solution with CFM features enabled, cannot have egress security filters.
Configuration of ingress groups are subject to the sub-category to which a group belongs. Sub-category of each group is shown below:
 
Table 34-105: Sub-category of groups
Category
Groups in the category
default (ingress)
ingress-l2
ingress-l2-ext
ingress-ipv4
ingress-ipv4-ext
ingress-ipv4-qos
qos
qos-ext
qos-policer
Ipv6 (ingress)
ingress-ipv6, ingress-ipv6-qos, qos-ipv6, ingress-ipv6-ext, ingress-ipv6-ext-vlan
default (egress)
egress-l2, egress-ipv4
cfm (egress)
cfm-domain-name-str
Note: Per sub-category, not more than three groups can be created if the group key size is 320 bits wide.
Last modified date: 10/19/2023