Table Of Contents
show mls qos
show mls qos aggregate policer
show mls qos free-agram
show mls qos maps
show mls qos mpls
show mls qos protocol
show mls qos statistics-export info
show platform qos policy-map
show policy-map
show policy-map class
show policy-map control-plane
show policy-map interface
show policy-map interface brief
show policy-map interface service instance
show policy-map mgre
show policy-map session
show protocol phdf
show qbm client
show qbm pool
show qdm status
show queue
show queueing
show queueing interface
show table-map
show tech-support rsvp
show traffic-shape
show traffic-shape queue
show traffic-shape statistics
show vrf
svc-bundle
table-map (value mapping)
tcp
tcp contexts
traffic-shape adaptive
traffic-shape fecn-adapt
traffic-shape group
traffic-shape rate
tx-ring-limit
vc-hold-queue
wrr-queue bandwidth
wrr-queue cos-map
wrr-queue dscp-map
wrr-queue queue-limit
wrr-queue random-detect
wrr-queue threshold
show mls qos
To display multilayer switching (MLS) quality of service (QoS) information, use the show mls qos command in privileged EXEC mode.
show mls qos [{arp | ipv6 | ip | ipx | last | mac | module [module-number]} [interface
interface-number | slot slot | null 0 | port-channel number | vlan vlan-id]] [detailed]
Syntax Description
arp
|
(Optional) Displays Address Resolution Protocol (ARP) information.
|
ipv6
|
(Optional) Displays IPv6 information.
|
ip
|
(Optional) Displays information about the MLS IP status.
|
ipx
|
(Optional) Displays information about the MLS Internetwork Packet Exchange (IPX) status.
|
last
|
(Optional) Displays information about the last packet-policing.
|
mac
|
(Optional) Displays information about the MAC address-based QoS status.
|
module module-number
|
(Optional) Specifies the module (slot) number; displays the global and per-interface QoS enabled and disabled settings and the global QoS counters.
|
interface
|
(Optional) Interface type; valid values are ethernet, fastethernet, gigabitethernet, tengigabitethernet, ge-wan, pos, and atm.
|
interface-number
|
(Optional) Module and port number; see the "Usage Guidelines" section for valid values.
|
slot slot
|
(Optional) Specifies the slot number; displays the global and per-interface QoS enabled and disabled settings and the global QoS counters.
|
null 0
|
(Optional) Specifies the null interface; the only valid value is 0.
|
port-channel number
|
(Optional) Specifies the channel interface; there is a maximum of 64 values ranging from 1 to 282.
|
vlan vlan-id
|
(Optional) Specifies the VLAN ID; valid values are from 1 to 4094.
|
detailed
|
(Optional) Displays additional statistics.
|
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(14)SX
|
This command was introduced on the Supervisor Engine 720.
|
12.2(17d)SXB
|
This command was implemented on the Supervisor Engine 2 and integrated into Cisco IOS Release 12.2(17d)SXB.
|
12.2(18)SXE
|
The arpand ipv6 keywords were added on the Supervisor Engine 720 only.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SXI
|
• The following information was added to the command output on the Catalyst 6500 series switch:
– Display of last 30-second counters.
– Display of peak 30-second counters over the last 5 minutes.
– Display of 5-minute average and peak packets-per-second (pps) rates.
• The peak rates are monitored with 10-second resolution. Releases prior to Cisco IOS Release 12.2(33)SXI were monitored at 30-second resolution.
|
Usage Guidelines
The ge-wan, pos, and atm interfaces are not supported on systems that are configured with a Supervisor Engine 720.
The interface-number argument designates the module and port number. Valid values for interface-number depend on the specified interface type and the chassis and module that are used. For example, if you specify a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot chassis, valid values for the module number are from 1 to 13 and valid values for the port number are from 1 to 48.
The port-channel number values from 257 to 282 are supported on the Content Switching Module (CSM) and the Firewall Services Module (FWSM) only.
Catalyst 6500 Series Switches
In Cisco IOS Release 12.2(33)SXI and later releases, the following information is included in the output of the show mls qos command:
•
Display of last 30-second counters.
•
Display of peak 30-second counters over the last 5 minutes.
•
Display of 5-minute average and peak bps rates.
The peak rates are monitored with 10-second resolution. Releases prior to Cisco IOS Release 12.2(33)SXI are monitored at 30-second resolution.
Examples
Last Logged Packet Example
This example shows how to display information about the last logged packet:
Router# show mls qos last
QoS engine last packet information:
Output TOS/DSCP: 0xC0/48[unchanged] Output COS: 0[unchanged]
Aggregate policer index: 0(none)
Microflow policer index: 0(none)
IPv6 Example
This example shows how to display IPv6 information:
Router# show mls qos ipv6
QoS Summary [IPv6]: (* - shared aggregates, Mod - switch module)
Int Mod Dir Class-map DSCP Agg Trust Fl AgForward-By AgPoliced-By
------------------------------------------------------------------------------
All 7 - Default 0 0* No 0 189115356 0
Supervisor Engine 720 Example
This example shows how to display QoS information:
Microflow policing is enabled globally
QoS ip packet dscp rewrite enabled globally
QoS is disabled on the following interfaces:
QoS DSCP-mutation map is enabled on the following interfaces:
Vlan or Portchannel(Multi-Earl) policies supported: Yes
Egress policies supported: Yes
Packets dropped by policing: 0
IP packets with TOS changed by policing: 0
IP packets with COS changed by policing: 0
Non-IP packets with COS changed by policing: 0
MPLS packets with EXP changed by policing: 0
Supervisor Engine 2 Example
This example shows the output if you do not enter any keywords:
Microflow QoS is enabled globally
Packets dropped by policing: 344
IP packets with TOS changed by policing 18323
IP packets with COS changed by policing 1602
Non-IP packets with COS changed by policing 0
Catalyst 6500 Series Switches Example
The show mls qos command output in Cisco IOS Release 12.2(33)SXI and later releases contains more packet counter information than in previous releases.
This example shows the Cisco IOS Release 12.2(33)SXI output with the detailed keyword:
Router# show mls qos detailed
Policy marking depends on port_trust
QoS ip packet dscp rewrite enabled globally
Input mode for GRE Tunnel is Pipe mode
Input mode for MPLS is Pipe mode
Vlan or Portchannel(Multi-Earl) policies supported: Yes
Egress policies supported: Yes
Traffic: Total pkt's 30-s pkt's peak pkts 5-min avg pps peak pps
-----------------------------------------------------------------------------------
Total packets: 775606 46 22 2 5
IP shortcut packets: 5465402 33 16 1 1
changed by policing: 41 10 4 0 0
changed by policing: 2 0 0 0 0
changed by policing: 0 0 0 0 0
changed by policing: 0 0 0 0 0
Table 157 describes the significant fields added when you enter the detailed keyword.
Table 157 show mls qos detailed Field Descriptions
Field
|
Description
|
Total packets
|
The cumulative counters.
|
IP shortcut packets
|
Number of IP shortcut packets.
|
Packets dropped by policing
|
Number of police dropped packets.
|
Packets changed by policing
|
Number of police modified packets.
|
30-s pkts
|
The total 30-second packet count over the last 5 minutes.
|
30-s peak pkts
|
The peak 30-second packet count over the last 5 minutes.
|
5-min avg pps
|
The average packets-per-second (pps) rate over the last 5 minutes.
|
5-min peak pps
|
The peak pps rate over the last 5 minutes.
|
Related Commands
Command
|
Description
|
mls qos (global configuration mode)
|
Enables the QoS functionality globally.
|
mls qos (interface configuration mode)
|
Enables the QoS functionality on an interface.
|
show mls qos aggregate-policer
|
Displays information about the aggregate policer.
|
show mls qos free-agram
|
Displays the number of free aggregate RAM indexes on the switch processor and the DFCs.
|
show mls qos interface
|
Displays MLS QoS information at the interface level.
|
show mls qos maps
|
Displays MLS QoS mapping information.
|
show mls qos mpls
|
Displays an interface summary for MPLS QoS classes in policy maps.
|
show mls qos protocol
|
Displays protocol pass-through information.
|
show mls qos statistics-export
|
Displays MLS statistics data-export status and configuration.
|
show mls qos aggregate policer
To display information about the aggregate policer for multilayer switching (MLS) quality of service (QoS), use the show mls qos aggregate policer command in EXEC mode.
show mls qos aggregate policer [aggregate-name]
Syntax Description
aggregate-name
|
(Optional) Name of the aggregate policer.
|
Command Default
This command has no default settings.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(14)SX
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(17d)SXB
|
This command was implemented on the Supervisor Engine 2 and integrated into Cisco IOS Release 12.2(17d)SXB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
Usage Guidelines
Aggregate policing works independently on each Distributed Forwarding Card (DFC)-equipped switching module and independently on the Policy Feature Card 2 (PFC2), which supports any non-DFC-equipped switching modules. Aggregate policing does not combine flow statistics from different DFC-equipped switching modules. You can display aggregate-policing statistics for each DFC-equipped switching module, the PFC2, and any non-DFC-equipped switching modules that are supported by the PFC2.
Examples
This example shows how to display information about the aggregate policer for MLS QoS:
Router# show mls qos aggregate-policer
ag2 64000 64000 conform-action set-dscp-transmit 56 exceed-action drop
ag3 32000 32000 conform-action set-dscp-transmit 34 exceed-action drop
In the output, the following applies:
•
The AgId parameter displays the hardware-policer ID and is nonzero if assigned.
•
The policy maps using the policer, if any, are listed in the square brackets ([]).
•
If there are no policies using the policer, no AgId line is displayed.
•
If the policer is referred to in policy maps, but has not been defined, [undefined] is displayed.
Related Commands
Command
|
Description
|
mls qos aggregate-policer
|
Defines a named aggregate policer for use in policy maps.
|
show mls qos free-agram
To display the number of free aggregate RAM indexes on the switch processor and the Distributed Forwarding Cards (DFCs), use the show mls qos free-agram command in EXEC mode.
show mls qos free-agram
Syntax Description
This command has no arguments or keywords.
Command Default
This command has no default settings.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(18)SXD
|
Support for this command was introduced on the Supervisor Engine 720 and the Supervisor Engine 2.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
Examples
This example shows how to display the number of free aggregate RAM indexes on the switch processor and the DFCs:
Router# show mls qos free-agram
Total Number of Available AG RAM indices : 1023
show mls qos maps
To display multilayer switching (MLS) quality of service (QoS) mapping information, use the show mls qos maps command in privileged EXEC mode.
Cisco 2600, 3660, 3700, 3845, 7200, 7400, and 7500 Series Routers
show mls qos maps [cos-dscp | dscp-cos]
Cisco 7600 Series Router and Catalyst 6500 Series Switch
show mls qos maps [cos-dscp | cos-mutation | dscp-cos | dscp-exp | dscp-mutation | exp-dscp |
exp-mutation | ip-prec-dscp | policed-dscp]
Syntax Description
cos-dscp
|
(Optional) Displays the class of service (CoS)-to-differentiated services code point (DSCP) map.
|
dscp-cos
|
(Optional) Displays the DSCP-to-CoS map.
|
cos-mutation
|
(Optional) Displays the CoS-mutation map.
|
dscp-exp
|
(Optional) Displays the DSCP-to-exp map.
|
dscp-mutation
|
(Optional) Displays the DSCP-mutation map.
|
exp-dscp
|
(Optional) Displays the exp-to-DSCP map.
|
exp-mutation
|
(Optional) Displays the exp-mutation map.
|
ip-prec-dscp
|
(Optional) Displays the IP-precedence-to-DSCP map.
|
policed-dscp
|
(Optional) Displays the policed-DSCP map.
|
Command Default
All MLS QoS maps are displayed.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.1(6)EA2
|
This command was introduced.
|
12.2(14)SX
|
This command was implemented on the Cisco 7600 series routers.
|
12.2(15)ZJ
|
This command was implemented on the following platforms: Cisco 2600 series routers, Cisco 3600 series routers, and Cisco 3700 series routers.
|
12.2(17b)SXA
|
This command was changed to support the cos-mutation, exp-dscp, and exp-mutation keywords.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.3(4)T
|
This command was integrated into Cisco IOS Release 12.3(4)T on the following platforms: Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series routers.
|
12.2(33)SXI
|
Support was added for all map type keywords.
|
Usage Guidelines
Maps are used to generate an internal DSCP value, which represents the priority of the traffic. Use the show mls qos maps command without keywords to display all maps.
Examples
The following is sample output from the show mls qos maps cos-dscp command displaying the DSCP values to which each CoS value will be mapped:
Router# show mls qos maps cos-dscp
--------------------------------
dscp: 8 8 8 8 24 32 56 56
The following is sample output from the show mls qos maps dscp-cos command displaying the CoS values to which each DSCP value will be mapped:
Router# show mls qos maps dscp-cos
dscp: 0 8 10 16 18 24 26 32 34 40 46 48 56
-----------------------------------------------
cos: 0 1 1 1 2 2 3 3 4 4 5 6 7
This example shows how to display the QoS-map settings:
Router# show mls qos maps
----------------------------------
00: 00 01 02 03 04 05 06 07 08 09
10: 10 11 12 13 14 15 16 17 18 19
20: 20 21 22 23 24 25 26 27 28 29
30: 30 31 32 33 34 35 36 37 38 39
40: 40 41 42 43 44 45 46 47 48 49
50: 50 51 52 53 54 55 56 57 58 59
----------------------------------
00: 00 00 00 00 00 00 00 00 01 01
10: 01 01 01 01 01 01 02 02 02 02
20: 02 02 02 02 03 03 03 03 03 03
30: 03 03 04 04 04 04 04 04 04 04
40: 05 05 05 05 05 05 05 05 06 06
50: 06 06 06 06 06 06 07 07 07 07
----------------------------------
dscp: 0 8 16 24 32 40 48 56
----------------------------------
dscp: 0 8 16 24 32 40 48 56
In the policed DSCP and DSCP-CoS map displays, the new DSCP or CoS values are shown in the body of the table. The decade of the original DSCP value is shown in the left-side vertical column, and the units digit is in the top row. For example, the DSCP-CoS map indicates that if the original DSCP value is between 32 and 39, the CoS will be set to 4.
The CoS-DSCP and IP precedence-DSCP maps display the DSCP values to which each CoS or IP precedence value will be mapped. For example, the IP precedence-DSCP map indicates that if the original IP precedence value is 3, the DSCP will be set to 24.
This example shows how to verify the configuration of DSCP-mutation mapping:
Router# show mls qos maps | begin DSCP mutation
DSCP mutation map mutmap1: (dscp= d1d2)
d1 : d2 0 1 2 3 4 5 6 7 8 9
-------------------------------------
0 : 00 01 02 03 04 05 06 07 08 09
1 : 10 11 12 13 14 15 16 17 18 19
2 : 20 21 22 23 24 25 26 27 28 29
3 : 08 31 32 33 34 35 36 37 38 39
4 : 40 41 42 43 44 45 46 47 48 49
In the DSCP mutation map display, the marked-down DSCP values are shown in the body of the table. The first digit (d1) of the original DSCP value is in the left-side vertical column labeled d1, and the second digit (d2) is in the top row. For example, a DSCP value of 30 maps to a new DSCP value of 08.
Related Commands
Command
|
Description
|
mls qos map
|
Defines the CoS-to-DSCP map and DSCP-to-CoS map.
|
mls qos map cos-dscp
|
Defines the ingress CoS-to-DSCP map for trusted interfaces.
|
mls qos map cos-mutation
|
Maps a packet's CoS to a new CoS value.
|
mls qos map dscp-cos
|
Defines an egress DSCP-to-CoS map.
|
mls qos map dscp-mutation
|
Defines a named DSCP mutation map.
|
mls qos map ip-prec-dscp
|
Defines an ingress IP precedence-to-DSCP map for trusted interfaces.
|
mls qos map policed-dscp
|
Sets the mapping of policed DSCP values to marked-down DSCP values.
|
show mls qos mpls
To display an interface summary for Multiprotocol Label Switching (MPLS) quality of service (QoS) classes in policy maps, use the show mls qos mpls command in user EXEC or privileged EXEC mode.
show mls qos mpls [interface-type interface-number | module slot]
Syntax Description
interface-type interface-number
|
(Optional) Interface type; valid values are the following:
• fastethernet
• gigabitethernet
• tengigabitethernet.
(Optional) Module and port number; see the "Usage Guidelines" section for valid values.
|
module slot
|
(Optional) Specifies the module slot number.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.2(17a)SX
|
This command was introduced on the Supervisor Engine 720.
|
12.2(33)SRB
|
This command was integrated into Cisco IOS Release 12.2(33)SRB.
|
Usage Guidelines
This command is supported in PFC3BXL or PFC3B mode only.
The interface-number argument designates the module and port number. Valid values for interface-number depend on the specified interface type and the chassis and module that are used. For example, if you specify a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot chassis, valid values for the module number are from 1 to 13 and valid values for the port number are from 1 to 48.
Examples
The following example shows an interface summary for MPLS QoS classes in policy maps:
Router# show mls qos mpls
QoS Summary [MPLS]: (* - shared aggregates, Mod - switch module)
Int Mod Dir Class-map DSCP Agg Trust Fl AgForward-By AgPoliced-By
------------------------------------------------------------------------------------------
----------------------------
Fa3/38 5 In exp2 0 1 dscp 0 378900 0
Fa3/41 5 In exp4 0 3 dscp 0 0 0
All 5 - Default 0 0* No 0 1191011240 0
Table 158 describes the significant fields shown in the display.
Table 158 show mls qos mpls Field Descriptions
Field
|
Description
|
QoS Summary [MPLS]: (* - shared aggregates, Mod - switch module)
|
Shows if there are any shared aggregate policers, indicated by *, and the type of module.
|
Int Mod Dir Class-map DSCP Agg Trust Fl AgForward-By AgPoliced-By
|
Provides the column headings for the following lines in the display. These include interface name and number, module number, direction, class-map name, and DSCP value.
|
Fa3/38 5 In exp2 0 1 dscp 0 378900 0
|
Provides the following information:
• Fa3/38—Interface name and number.
• 5—Module number in the chassis.
• In—Direction of the policy applied (In = ingress).
• exp2—Class map configured in the policy.
• 0—Differentiated Services Code Point (DSCP) value.
• 1—Policer ID assigned to that class map.
• dscp—Trust value configured on the port. In this example, the value is trusting on DSCP.
• 0—The flow ID if the flow policer is configured.
• 378900—The aggregate forwarded bytes, meaning the forwarded traffic.
• 0—The aggregate policed bytes, meaning this traffic has been subjected to policing.
|
All 5 - Default 0 0* No 0 1191011240 0
|
The total of the preceding lines including the aggregate forwarded and aggregate policed bytes.
|
Related Commands
Command
|
Description
|
mls qos exp-mutation
|
Attaches an egress-EXP mutation map to the interface.
|
mls qos map exp-dscp
|
Defines the ingress EXP value to the internal DSCP map.
|
mls qos map exp-mutation
|
Maps a packet's EXP to a new EXP value.
|
show mls qos protocol
To display protocol pass-through information, use the show mls qos protocol command in EXEC mode.
show mls qos protocol [module number]
Syntax Description
module number
|
(Optional) Specifies the module number.
|
Command Default
This command has no default settings.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(17a)SX
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(18)SXE
|
Support for this command was introduced on the Supervisor Engine 2 but does not support Address Resolution Protocol (ARP), Integrated Intermediate System-to-Intermediate System (IS-IS), or Enhanced Interior Gateway Routing Protocol (EIGRP).
Support for neighbor discovery protocol packets was added on the Supervisor Engine 720 only.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
Examples
This example shows how to display protocol pass-through information:
Router# show mls qos protocol
ND : Policing mode Cir = 32000 Burst = 1000
Routing protocol RIP is using AgId 0*
Routing protocol OSPF is using AgId 0*
Routing protocol ND is using AgId 1
Routing protocol RIP is using AgId 0*
Routing protocol OSPF is using AgId 0*
Related Commands
Command
|
Description
|
mls qos protocol
|
Defines the routing-protocol packet policing.
|
show mls qos statistics-export info
To display information about the multilayer switching (MLS)-statistics data-export status and configuration, use the show mls qos statistics-export info command in EXEC mode
show mls qos statistics-export info
Syntax Description
This command has no keywords or arguments.
Command Default
This command has no default settings.
Command Modes
EXEC
Command History
Release
|
Modification
|
12.2(14)SX
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(17d)SXB
|
This command was implemented on the Supervisor Engine 2 and integrated into Cisco IOS Release 12.2(17d)SXB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
Usage Guidelines
Quality of service (QoS)-statistics data export is not supported on Optical Service Module (OSM) interfaces.
Examples
This example shows how to display information about the MLS-statistics data-export status and configuration:
Router# show mls qos statistics-export info
QoS Statistics Data Export Status and Configuration information
---------------------------------------------------------------
Export Interval : 250 seconds
Export Destination : 172.20.52.3, UDP port 514 Facility local6, Severity debug
QoS Statistics Data Export is enabled on following ports:
---------------------------------------------------------
QoS Statistics Data export is enabled on following shared aggregate policers:
-----------------------------------------------------------------------------
QoS Statistics Data Export is enabled on following class-maps:
---------------------------------------------------------------
Related Commands
Command
|
Description
|
mls qos statistics-export (global configuration)
|
Enables QoS-statistics data export globally.
|
mls qos statistics-export (interface configuration)
|
Enables per-port QoS-statistics data export.
|
mls qos statistics-export aggregate-policer
|
Enables QoS-statistics data export on the named aggregate policer.
|
mls qos statistics-export class-map
|
Enables QoS-statistics data export for a class map.
|
mls qos statistics-export delimiter
|
Sets the QoS-statistics data-export field delimiter.
|
mls qos statistics-export destination
|
Configures the QoS-statistics data-export destination host and UDP port number.
|
mls qos statistics-export interval
|
Specifies how often a port and/or aggregate-policer QoS-statistics data is read and exported.
|
show platform qos policy-map
To display the type and number of policy maps that are configured on the router, use the show platform qos policy-map command in privileged EXEC mode.
show platform qos policy-map
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(18)SXE
|
This command was introduced for Cisco Catalyst 6500 series switches and Cisco 7600 series routers.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
Usage Guidelines
On Cisco Catalyst 6500 series switches and Cisco 7600 series routers, you cannot attach a quality of service (QoS) policy map with match input vlan to an interface if you have already attached a QoS policy map to a VLAN interface (a logical interface that has been created with the interface vlan command). If you attempt to use both types of service policies, you must remove both types of service policies before you can add the policy maps.
The show platform qos policy-map command shows whether the router is currently configured for interface vlan and match input vlan service policies. It also shows the number of policy maps for each type.
Examples
The following example shows a router that has service policies configured only on VLAN interfaces:
Router# show platform qos policy-map
service policy configured on int vlan: TRUE
# of int vlan service policy instances: 3
match input vlan service policy configured: FALSE
# of match input vlan service policy instances: 0
The following example shows a router that has service policies configured on VLAN interfaces and that has a service policy configured with match input vlan. In this configuration, you must remove all service policies from their interfaces, and then configure only one type or another.
Router# show platform qos policy-map
service policy configured on int vlan: TRUE
# of int vlan service policy instances: 1
match input vlan service policy configured: TRUE
# of match input vlan service policy instances: 1
Table 159 describes each field shown in the show platform qos policy-map command:
Table 159 show platform qos policy-map Field Descriptions
Field
|
Description
|
service policy configured on int vlan
|
Indicates whether any QoS policy maps are configured on VLAN interfaces.
|
# of int vlan service policy instances
|
Number of QoS policy maps that are configured on VLAN interfaces.
|
match input vlan service policy configured
|
Indicates whether any QoS policy maps that use the match input vlan command are configured on interfaces.
|
# of match input vlan service policy instances
|
Number of QoS policy maps using the match input vlan command that are configured on interfaces.
|
Related Commands
Command
|
Description
|
match input vlan
|
Configures a class map to match incoming packets that have a specific virtual local area network (VLAN) ID.
|
match qos-group
|
Identifies a specified QoS group value as a match criterion.
|
mls qos trust
|
Sets the trusted state of an interface, to determine which incoming QoS field on a packet, if any, should be preserved.
|
policy-map
|
Creates or modifies a policy map that can be attached to one or more interfaces to specify a service policy.
|
service-policy
|
Attaches a policy map to an input interface or VC, or an output interface or VC, to be used as the service policy for that interface or VC.
|
show policy-map
|
Displays the configuration of all classes for a specified service policy map or all classes for all existing policy maps.
|
show policy-map interface
|
Displays the configuration of all classes configured for all service policies on the specified interface or displays the classes for the service policy for a specific PVC on the interface.
|
show platform qos policy-map
|
Displays the type and number of policy maps that are configured on the router.
|
show policy-map
To display the configuration of all classes for a specified service policy map or of all classes for all existing policy maps, use the show policy-map command in user EXEC or privileged EXEC mode.
show policy-map [policy-map]
Syntax Description
policy-map
|
(Optional) Name of the service policy map whose complete configuration is to be displayed. The name can be a maximum of 40 characters.
|
Command Default
All existing policy map configurations are displayed.
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.0(5)T
|
This command was introduced.
|
12.0(5)XE
|
This command was incorporated into Cisco IOS Release 12.0(5)XE.
|
12.0(7)S
|
This command was incorporated into Cisco IOS Release 12.0(7)S.
|
12.1(1)E
|
This command was incorporated into Cisco IOS Release 12.1(1)E.
|
12.2(4)T
|
This command was modified for two-rate traffic policing to display burst parameters and associated actions.
|
12.2(8)T
|
The command was modified for the Policer Enhancement—Multiple Actions feature and the Weighted Random Early Detection (WRED)—Explicit Congestion Notification (ECN) feature.
|
12.2(13)T
|
The following modifications were made:
• The output was modified for the Percentage-Based Policing and Shaping feature.
• This command was modified as part of the Modular QoS CLI (MQC) Unconditional Packet Discard feature. Traffic classes can now be configured to discard packets belonging to a specified class.
• This command was modified for the Enhanced Packet Marking feature. A mapping table (table map) can now be used to convert and propagate packet-marking values.
|
12.2(15)T
|
This command was modified to support display of Frame Relay voice-adaptive traffic-shaping information.
|
12.0(28)S
|
The output of this command was modified for the QoS: Percentage-Based Policing feature to display the committed (conform) burst (bc) and excess (peak) burst (be) sizes in milliseconds (ms).
|
12.2(14)SX
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(17d)SXB
|
This command was implemented on the Supervisor Engine 2 and integrated into Cisco IOS Release 12.2(17d)SXB.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB, and the command was modified to display information about Layer 2 Tunnel Protocol Version 3 (L2TPv3) tunnel marking.
|
12.2(31)SB2
|
This command was enhanced to display bandwidth-remaining ratios configured on traffic classes and ATM overhead accounting, and was implemented on the Cisco 10000 series router for the PRE3.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SRC
|
Support for the Cisco 7600 series router was added.
|
12.4(15)T2
|
This command was modified to display information about Generic Routing Encapsulation (GRE) tunnel marking.
Note For this release, GRE-tunnel marking is supported on the Cisco MGX Route Processor Module (RPM-XF) platform only.
|
12.2(33)SB
|
This command was modified to display information about GRE-tunnel marking, and support for the Cisco 7300 series router was added. This command's output was modified on the Cisco 10000 series router for the PRE3 and PRE4.
|
Cisco IOS XE 2.1
|
This command was integrated into Cisco IOS XE Release 2.1 and was implemented on the Cisco ASR 1000 series router.
|
12.4(20)T
|
Support was added for hierarchical queueing framework (HQF) using the Modular Quality of Service (QoS) Command-Line Interface (CLI) (MQC).
|
Usage Guidelines
The show policy-map command displays the configuration of a policy map created using the policy-map command. You can use the show policy-map command to display all class configurations comprising any existing service policy map, whether or not that policy map has been attached to an interface. The command displays:
•
ECN marking information only if ECN is enabled on the interface.
•
Bandwidth-remaining ratio configuration and statistical information, if configured and used to determine the amount of unused (excess) bandwidth to allocate to a class queue during periods of congestion.
Cisco 10000 Series Router
In Cisco IOS Release 12.2(33)SB, the output of the show policy-map command is slightly different from previous releases when the policy is an hierarchical policy.
For example, in Cisco IOS Release 12.2(33)SB output similar to the following displays when you specify a hierarchical policy in the show policy-map command:
Router# show policy-map Bronze
In Cisco IOS Release 12.2(31)SB, output similar to the following displays when you specify a hierarchical policy in the show policy-map command:
Router# show policy-map Gold
Average Rate Traffic Shaping
In Cisco IOS Release 12.2(33)SB, the output from the show policy-map command displays police actions on separate lines as shown in the following sample output:
Router# show policy-map Premium
police percent 50 25 ms 0 ms
In Cisco IOS Release 12.2(31)SB, the output from the show policy-map command displays police actions on one line as shown in the following sample output:
Router# show policy-map Premium
police percent 50 25 ms 0 ms conform-action transmit exceed-action transmit violate-
action drop
Examples
This section provides sample output from typical show policy-map commands. Depending upon the interface or platform in use and the options enabled (for example, Weighted Fair Queueing [WFQ]), the output you see may vary slightly from the ones shown below.
•
Weighted Fair Queueing: Example
•
Frame Relay Voice-Adaptive Traffic-Shaping: Example
•
Traffic Policing: Example
•
Two-Rate Traffic Policing: Example
•
Multiple Traffic Policing Actions: Example
•
Explicit Congestion Notification: Example
•
Modular QoS CLI (MQC) Unconditional Packet Discard: Example
•
Percentage-Based Policing and Shaping: Example
•
Enhanced Packet Marking: Example
•
Bandwidth-Remaining Ratio: Example
•
ATM Overhead Accounting: Example
•
Tunnel Marking: Example
•
HQF: Example 1
•
HQF: Example 2
Weighted Fair Queueing: Example
The following example displays the contents of the service policy map called po1. In this example, WFQ is enabled.
Router# show policy-map po1
Policy Map po1
Weighted Fair Queueing
Class class1
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class2
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class3
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class4
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class5
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class6
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class7
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class8
Bandwidth 937 (kbps) Max thresh 64 (packets)
The following example displays the contents of all policy maps on the router. Again, WFQ is enabled.
Policy Map poH1
Weighted Fair Queueing
Class class1
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class2
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class3
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class4
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class5
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class6
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class7
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class8
Bandwidth 937 (kbps) Max thresh 64 (packets)
Policy Map policy2
Weighted Fair Queueing
Class class1
Bandwidth 300 (kbps) Max thresh 64 (packets)
Class class2
Bandwidth 300 (kbps) Max thresh 64 (packets)
Class class3
Bandwidth 300 (kbps) Max thresh 64 (packets)
Class class4
Bandwidth 300 (kbps) Max thresh 64 (packets)
Class class5
Bandwidth 300 (kbps) Max thresh 64 (packets)
Class class6
Bandwidth 300 (kbps) Max thresh 64 (packets)
Table 160 describes the significant fields shown in the display.
Table 160 show policy-map Field Descriptions—Configured for WFQ
Field
|
Description
|
Policy Map
|
Policy map name.
|
Class
|
Class name.
|
Bandwidth
|
Amount of bandwidth in kbps allocated to class.
|
Max thresh
|
Maximum threshold in number of packets.
|
Frame Relay Voice-Adaptive Traffic-Shaping: Example
The following sample output for the show-policy map command indicates that Frame Relay voice-adaptive traffic-shaping is configured in the class-default class in the policy map "MQC-SHAPE-LLQ1" and that the deactivation timer is set to 30 seconds.
Bandwidth 10 (kbps) Burst 250 (Bytes)
Bandwidth 8 (kbps) Max Threshold 64 (packets)
Bandwidth 15 (kbps) Max Threshold 64 (packets)
Policy Map MQC-SHAPE-LLQ1
Average Rate Traffic Shaping
CIR 63000 (bps) Max. Buffers Limit 1000 (Packets)
Voice Adapt Deactivation Timer 30 Sec
Table 161 describes the significant fields shown in the display.
Table 161 show policy-map Field Descriptions—Configured for Frame Relay Voice-Adaptive Traffic-Shaping
Field
|
Description
|
Strict Priority
|
Indicates the queueing priority assigned to the traffic in this class.
|
Burst
|
Specifies the traffic burst size in bytes.
|
Traffic Shaping
|
Indicates that Traffic Shaping is enabled.
|
Average Rate Traffic Shaping
|
Indicates the type of Traffic Shaping enabled. Choices are Peak Rate Traffic Shaping or Average Rate Traffic Shaping.
|
CIR
|
Committed Information Rate (CIR) in bps.
|
Max. Buffers Limit
|
Maximum memory buffer size in packets.
|
Adapt to
|
Traffic rate when shaping is active.
|
Voice Adapt Deactivation Timer
|
Indicates that Frame Relay voice-adaptive traffic-shaping is configured, and that the deactivation timer is set to 30 seconds.
|
service-policy
|
Name of the service policy configured in the policy map "MQC-SHAPE-LLQ1".
|
Traffic Policing: Example
The following is sample output from the show policy-map command. This sample output displays the contents of a policy map called "policy1." In policy 1, traffic policing on the basis of a committed information rate (CIR) of 20 percent has been configured, and the bc and be have been specified in milliseconds. As part of the traffic policing configuration, optional conform, exceed, and violate actions have been specified.
Router# show policy-map policy1
police cir percent 20 bc 300 ms pir percent 40 be 400 ms
Table 162 describes the significant fields shown in the display.
Table 162 show policy-map Field Descriptions—Configured for Traffic Policing
Field
|
Description
|
Policy Map
|
Name of policy map displayed.
|
Class
|
Name of the class configured in the policy map displayed.
|
police
|
Indicates that traffic policing on the basis of specified percentage of bandwidth has been enabled. The committed burst (Bc) and excess burst (Be) sizes have been specified in milliseconds (ms), and optional conform, exceed, and violate actions have been specified.
|
Two-Rate Traffic Policing: Example
The following is sample output from the show policy-map command when two-rate traffic policing has been configured. As shown below, two-rate traffic policing has been configured for a class called "police." In turn, the class called police has been configured in a policy map called "policy1." Two-rate traffic policing has been configured to limit traffic to an average committed rate of 500 kbps and a peak rate of 1 Mbps.
Router(config)# class-map police
Router(config-cmap)# match access-group 101
Router(config-cmap)# policy-map policy1
Router(config-pmap)# class police
Router(config-pmap-c)# police cir 500000 bc 10000 pir 1000000 be 10000 conform-action
transmit exceed-action set-prec-transmit 2 violate-action drop
Router(config-pmap-c)# interface serial3/0
Router(config-pmap-c)# exit
Router(config-pmap)# exit
Router(config)# interface serial3/0
Router(config-if)# service-policy output policy1
The following sample output shows the contents of the policy map called "policy1":
Router# show policy-map policy1
police cir 500000 conform-burst 10000 pir 1000000 peak-burst 10000 conform-action
transmit exceed-action set-prec-transmit 2 violate-action drop
Traffic marked as conforming to the average committed rate (500 kbps) will be sent as is. Traffic marked as exceeding 500 kbps, but not exceeding 1 Mbps, will be marked with IP Precedence 2 and then sent. All traffic exceeding 1 Mbps will be dropped. The burst parameters are set to 10000 bytes.
Table 163 describes the significant fields shown in the display.
Table 163 show policy-map Field Descriptions—Configured for Two-Rate Traffic Policing
Field
|
Description
|
police
|
Indicates that the police command has been configured to enable traffic policing. Also, displays the specified CIR, conform burst size (bc), peak information rate (PIR), and peak burst (BE) size used for marking packets.
|
conform-action
|
Displays the action to be taken on packets conforming to a specified rate.
|
exceed-action
|
Displays the action to be taken on packets exceeding a specified rate.
|
violate-action
|
Displays the action to be taken on packets violating a specified rate.
|
Multiple Traffic Policing Actions: Example
The following is sample output from the show policy-map command when the Policer Enhancement—Multiple Actions feature has been configured. The following sample output from the show policy-map command displays the configuration for a service policy called "police." In this service policy, traffic policing has been configured to allow multiple actions for packets marked as conforming to, exceeding, or violating the CIR or the PIR shown in the example.
Router# show policy-map police
police cir 1000000 bc 31250 pir 2000000 be 31250
exceed-action set-prec-transmit 4
exceed-action set-frde-transmit
violate-action set-prec-transmit 2
violate-action set-frde-transmit
Packets conforming to the specified CIR (1000000 bps) are marked as conforming packets. These are transmitted unaltered.
Packets exceeding the specified CIR (but not the specified PIR, 2000000 bps) are marked as exceeding packets. For these packets, the IP Precedence level is set to 4, the discard eligibility (DE) bit is set to 1, and the packet is transmitted.
Packets exceeding the specified PIR are marked as violating packets. For these packets, the IP Precedence level is set to 2, the DE bit is set to 1, and the packet is transmitted.
Note
Actions are specified by using the action argument of the police command. For more information about the available actions, see the police command reference page.
Table 164 describes the significant fields shown in the display.
Table 164 show policy-map Field Descriptions—Configured for Multiple Traffic Policing Actions
Field
|
Description
|
police
|
Indicates that the police command has been configured to enable traffic policing. Also, displays the specified CIR, BC, PIR, and BE used for marking packets.
|
conform-action
|
Displays the one or more actions to be taken on packets conforming to a specified rate.
|
exceed-action
|
Displays the one or more actions to be taken on packets exceeding a specified rate.
|
violate-action
|
Displays the one or more actions to be taken on packets violating a specified rate.
|
Explicit Congestion Notification: Example
The following is sample output from the show policy-map command when the WRED—Explicit Congestion Notification (ECN) feature has been configured. The words "explicit congestion notification" (along with the ECN marking information) included in the output indicate that ECN has been enabled.
explicit congestion notification
class min-threshold max-threshold mark-probability
----------------------------------------------------------
----------------------------------------------------------
Table 165 describes the significant fields shown in the display.
Table 165 show policy-map Field Descriptions—Configured for ECN
Field
|
Description
|
explicit congestion notification
|
Indication that Explicit Congestion Notification is enabled.
|
class
|
IP precedence value.
|
min-threshold
|
Minimum threshold. Minimum WRED threshold in number of packets.
|
max-threshold
|
Maximum threshold. Maximum WRED threshold in number of packets.
|
mark-probability
|
Fraction of packets dropped when the average queue depth is at the maximum threshold.
|
Modular QoS CLI (MQC) Unconditional Packet Discard: Example
The following example displays the contents of the policy map called "policy1." All the packets belonging to the class called "c1" are discarded.
Router# show policy-map policy1
Table 166 describes the significant fields shown in the display.
Table 166 show policy-map Field Descriptions—Configured for MQC Unconditional Packet Discard
Field
|
Description
|
Policy Map
|
Name of the policy map being displayed.
|
Class
|
Name of the class in the policy map being displayed.
|
drop
|
Indicates that the packet discarding action for all the packets belonging to the specified class has been configured.
|
Percentage-Based Policing and Shaping: Example
The following example displays the contents of two service policy maps—one called "policy1" and one called "policy2." In policy1, traffic policing based on a CIR of 50 percent has been configured. In policy 2, traffic shaping based on an average rate of 35 percent has been configured.
Router# show policy-map policy1
Policy Map policy1
class class1
police cir percent 50
Router# show policy-map policy2
Policy Map policy2
class class2
shape average percent 35
The following example displays the contents of the service policy map called "po1":
Router# show policy-map po1
Policy Map po1
Weighted Fair Queueing
Class class1
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class2
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class3
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class4
Bandwidth 937 (kbps) Max thresh 64 (packets)
The following example displays the contents of all policy maps on the router:
Policy Map poH1
Weighted Fair Queueing
Class class1
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class2
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class3
Bandwidth 937 (kbps) Max thresh 64 (packets)
Class class4
Bandwidth 937 (kbps) Max thresh 64 (packets)
Policy Map policy2
Weighted Fair Queueing
Class class1
Bandwidth 300 (kbps) Max thresh 64 (packets)
Class class2
Bandwidth 300 (kbps) Max thresh 64 (packets)
Class class3
Bandwidth 300 (kbps) Max thresh 64 (packets)
Class class4
Bandwidth 300 (kbps) Max thresh 64 (packets)
Table 167 describes the significant fields shown in the display.
Table 167 show policy-map Field Descriptions—Configured for Percentage-Based Policing and Shaping
Field
|
Description
|
Policy Map
|
Name of policy map displayed.
|
Weighted Fair Queueing
|
Indicates that weighted fair queueing (WFQ) has been enabled.
|
Class
|
Name of class configured in policy map displayed.
|
Bandwidth
|
Bandwidth, in kbps, configured for this class.
|
Max threshold
|
Maximum threshold. Maximum WRED threshold in number of packets.
|
Enhanced Packet Marking: Example
The following sample output from the show policy-map command displays the configuration for policy maps called "policy1" and "policy2".
In "policy1", a table map called "table-map-cos1" has been configured to determine the precedence based on the class of service (CoS) value. Policy map "policy 1" converts and propagates the packet markings defined in the table map called "table-map-cos1".
The following sample output from the show policy-map command displays the configuration for service polices called "policy1" and "policy2". In "policy1", a table map called "table-map1" has been configured to determine the precedence according to the CoS value. In "policy2", a table map called "table-map2" has been configured to determine the CoS value according to the precedence value.
Router# show policy-map policy1
set precedence cos table table-map1
Router# show policy-map policy2
set cos precedence table table-map2
Table 168 describes the fields shown in the display.
Table 168 show policy-map Field Descriptions—Configured for Enhanced Packet Marking
Field
|
Description
|
Policy Map
|
Name of the policy map being displayed.
|
Class
|
Name of the class in the policy map being displayed.
|
set precedence cos table table-map1
or
set cos precedence table table-map2
|
Name of the set command used to set the specified value.
For instance, set precedence cos table-map1 indicates that a table map called "table-map1" has been configured to set the precedence value on the basis of the values defined in the table map.
Alternately, set cos table table-map2 indicates that a table map called "table-map2" has been configured to set the CoS value on the basis of the values defined in the table map.
|
Bandwidth-Remaining Ratio: Example
The following sample output for the show policy-map command indicates that the class-default class of the policy map named vlan10_policy has a bandwidth-remaining ratio of 10. When congestion occurs, the scheduler allocates class-default traffic 10 times the unused bandwidth allocated in relation to other subinterfaces.
Router# show policy-map vlan10_policy
Average Rate Traffic Shaping
bandwidth remaining ratio 10
service-policy child_policy
Table 169 describes the fields shown in the display.
Table 169 show policy-map Field Descriptions—Configured for Bandwidth-Remaining Ratio
Field
|
Description
|
Policy Map
|
Name of the policy map being displayed.
|
Class
|
Name of the class in the policy map being displayed.
|
Average Rate Traffic Shaping
|
Indicates that Average Rate Traffic Shaping is configured.
|
cir
|
Committed information rate (CIR) used to shape traffic.
|
bandwidth remaining ratio
|
Indicates the ratio used to allocate excess bandwidth.
|
ATM Overhead Accounting: Example
The following sample output for the show policy-map command indicates that ATM overhead accounting is enabled for the class-default class. The BRAS-DSLAM encapsulation is dot1q and the subscriber encapsulation is snap-rbe for the AAL5 service.
Average Rate Traffic Shaping
cir 10% account dot1q aal5 snap-rbe
Table 170 describes the significant fields shown in the display.
Table 170 show policy-map Field Descriptions—Configured for ATM Overhead Accounting
Field
|
Description
|
Average Rate
|
Committed burst (Bc) is the maximum number of bits sent out in each interval.
|
cir 10%
|
Committed information rate (CIR) is 10 percent of the available interface bandwidth.
|
dot1q
|
BRAS-DSLAM encapsulation is 802.1Q VLAN.
|
aal5
|
DSLAM-CPE encapsulation type is based on the ATM Adaptation Layer 5 service. AAL5 supports connection-oriented variable bit rate (VBR) services.
|
snap-rbe
|
Subscriber encapsulation type.
|
Tunnel Marking: Example
In this sample output of the show policy-map command, the character string "ip precedence tunnel 4" indicates that tunnel marking (either L2TPv3 or GRE) has been configured to set the IP precedence value to 4 in the header of a tunneled packet.
Note
As of Cisco IOS Release 12.4(15)T2, GRE-tunnel marking is supported on the RPM-XF platform only.
Policy Map TUNNEL_MARKING
set ip precedence tunnel 4
Table 171 describes the fields shown in the display.
Table 171 show policy-map Field Descriptions—Configured for Tunnel Marking
Field
|
Description
|
Policy Map
|
Name of the policy map being displayed.
|
Class
|
Name of the class in the policy map being displayed.
|
set ip precedence tunnel
|
Indicates that tunnel marking has been configured.
|
HQF: Example 1
The following sample output from the show policy-map command displays the configuration for a policy map called "test1":
Router# show policy-map test1
Average Rate Traffic Shaping
Table 172 describes the fields shown in the display.
Table 172 show policy-map Field Descriptions—Configured for HQF
Field
|
Description
|
Policy Map
|
Name of the policy map being displayed.
|
Class
|
Name of the class in the policy map being displayed.
|
Average Rate Traffic Shaping
|
Indicates that Average Rate Traffic Shaping is configured.
|
cir
|
Committed information rate (CIR) in bps.
|
service-policy
|
Name of the service policy configured in policy map "test1".
|
HQF: Example 2
The following sample output from the show policy-map command displays the configuration for a policy map called "test2":
Router# show policy-map test2
packet-based wred, exponential weight 9
dscp min-threshold max-threshold mark-probablity
----------------------------------------------------------
Table 173 describes the fields shown in the display.
Table 173 show policy-map Field Descriptions—Configured for HQF
Field
|
Description
|
Policy Map
|
Name of the policy map being displayed.
|
Class
|
Name of the class in the policy map being displayed.
|
Average Rate Traffic Shaping
|
Indicates that Average Rate Traffic Shaping is configured.
|
priority
|
Indicates the queueing priority percentage assigned to traffic in this class.
|
bandwidth
|
Indicates the bandwidth percentage allocated to traffic in this class.
|
queue-limit
|
Indicates the queue limit in packets for this traffic class.
|
packet-based wred, exponential weight
|
Indicates that random detect is being applied and the units used are packets. Exponential weight is a factor for calculating the average queue size used with WRED.
|
dscp
|
Differentiated services code point (DSCP). Values can be the following:
• 0 to 63—Numerical DSCP values. The default value is 0.
• af1 to af43—Assured forwarding (AF) DSCP values.
• cs1 to cs7—Type of service (ToS) precedence values.
• default—Default DSCP value.
• ef—Expedited forwarding (EF) DSCP values.
|
min-threshold
|
Minimum threshold. Minimum WRED threshold in number of packets.
|
max-threshold
|
Maximum threshold. Maximum WRED threshold in number of packets.
|
mark-probability
|
Fraction of packets dropped when the average queue depth is at the maximum threshold.
|
Related Commands
Command
|
Description
|
bandwidth
|
Specifies or modifies the bandwidth allocated for a class belonging to a policy map, and enables ATM overhead accounting.
|
bandwidth remaining ratio
|
Specifies a bandwidth-remaining ratio for class queues and subinterface-level queues to determine the amount of unused (excess) bandwidth to allocate to the queue during congestion.
|
class (policy map)
|
Specifies the name of the class whose policy you want to create or change, and the default class (commonly known as the class-default class) before you configure its policy.
|
class-map
|
Creates a class map to be used for matching packets to a specified class.
|
drop
|
Configures a traffic class to discard packets belonging to a specific class.
|
police
|
Configures traffic policing.
|
police (two rates)
|
Configures traffic policing using two rates, the CIR and the PIR.
|
policy-map
|
Creates or modifies a policy map that can be attached to one or more interfaces to specify a service policy.
|
random-detect ecn
|
Enables ECN.
|
shape
|
Shapes traffic to the indicated bit rate according to the algorithm specified, and enables ATM overhead accounting.
|
show policy-map class
|
Displays the configuration for the specified class of the specified policy map.
|
show policy-map interface
|
Displays the packet statistics of all classes that are configured for all service policies either on the specified interface or subinterface or on a specific PVC on the interface.
|
show running-config
|
Displays the current configuration of the router. If configured, the command output includes information about ATM overhead accounting.
|
show table-map
|
Displays the configuration of a specified table map or of all table maps.
|
table-map (value mapping)
|
Creates and configures a mapping table for mapping and converting one packet-marking value to another.
|
show policy-map class
To display the configuration for the specified class of the specified policy map, use the show policy-map class command in user EXEC or privileged EXEC mode.
show policy-map policy-map class class-name
Syntax Description
policy-map
|
The name of a policy map that contains the class configuration to be displayed.
|
class-name
|
The name of the class whose configuration is to be displayed.
|
Command Modes
User EXEC (>)
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.0(5)T
|
This command was introduced.
|
12.0(5)XE
|
This command was integrated into Cisco IOS Release 12.0(5)XE.
|
12.0(7)S
|
This command was integrated into Cisco IOS Release 12.0(7)S.
|
12.1(1)E
|
This command was integrated into Cisco IOS Release 12.1(1)E.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
Cisco IOS XE Release 2.1
|
This command was implemented on Cisco ASR 1000 series routers.
|
Usage Guidelines
You can use the show policy-map class command to display any single class configuration for any service policy map, whether or not the specified service policy map has been attached to an interface.
Examples
The following example displays configurations for the class called class7 that belongs to the policy map called po1:
Router# show policy-map po1 class class7
Class class7
Bandwidth 937 (kbps) Max Thresh 64 (packets)
Related Commands
Command
|
Description
|
show policy-map
|
Displays the configuration of all classes for a specified service policy map or all classes for all existing policy maps.
|
show policy-map interface
|
Displays the configuration of all classes configured for all service policies on the specified interface or displays the classes for the service policy for a specific PVC on the interface.
|
show policy-map control-plane
To display the configuration and statistics for a traffic class or all traffic classes in the policy maps attached to the control plane for aggregate or distributed control plane services, use the show policy-map control-plane command in privileged EXEC mode.
Cisco 3660, 3800, 7200, 7400, and 7500 Series Routers
show policy-map control-plane [type policy-type] [all | slot slot-number] [host | transit |
cef-exception] [input [class class-name] | output [class class-name]]
Cisco 7600 and ASR 1000 Series Routers
show policy-map control-plane [all] [input [class class-name] | output [class class-name]]
Syntax Description
type policy-type
|
(Optional) Specifies policy-map type for which you want statistics (for example, port-filter or queue-threshold).
|
all
|
(Optional) Displays all QoS control plane policies used in aggregate and distributed control plane (CP) services.
|
slot slot-number
|
(Optional) Displays information about the quality of service (QoS) policy used to perform distributed CP services on the specified line card.
|
host
|
(Optional) Displays policy-map and class-map statistics for the host subinterface.
|
transit
|
(Optional) Displays policy-map and class-map statistics for the transit subinterface.
|
cef-exception
|
(Optional) Displays policy-map and class-map statistics for the Cef-exception subinterface.
|
input
|
(Optional) Displays statistics for the attached input policy.
|
output
|
(Optional) Displays statistics for the attached output policy.
Note The output keyword is supported only in Cisco IOS Release 12.3(4)T and later Cisco IOS 12.3T releases.
|
class class-name
|
(Optional) Name of the class whose configuration and statistics are to be displayed.
|
Command Default
Information displays for all classes of the policy map of the control plane.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(18)S
|
This command was introduced.
|
12.3(4)T
|
This command was integrated into Cisco IOS Release 12.3(4)T, and support for the output keyword was added.
|
12.0(29)S
|
This command was integrated into Cisco IOS Release 12.0(29)S.
|
12.2(18)SXD1
|
This command was integrated into Cisco IOS Release 12.2(18)SXD1.
|
12.0(30)S
|
The slot slot-number parameter was added to support distributed CP services.
|
12.4(4)T
|
Support was added for the type policy-type keyword and argument combination and for the host, transit, and cef-exception keywords.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
Cisco IOS XE Release 2.2
|
This command was implemented on Cisco ASR 1000 series routers.
|
Usage Guidelines
The show policy-map control-plane command displays information for aggregate and distributed control-plane policing services that manage the number or rate of control-plane (CP) packets sent to the process level of the route processor.
Information for distributed control-plane service is displayed for a specified line card. Distributed CP services are performed on a line card's distributed switch engine and manage CP traffic sent from all interfaces on the line card to the route processor, where aggregate CP services (for CP packets received from all line cards on the router) are performed.
Examples
The following example shows that the policy map TEST is associated with the control plane. This policy map polices traffic that matches the class map TEST, while allowing all other traffic (that matches the class map called "class-default") to go through as is.
Router# show policy-map control-plane
Service-policy input:TEST
Class-map:TEST (match-all)
5 minute offered rate 0 bps, drop rate 0 bps
8000 bps, 1500 limit, 1500 extended limit
conformed 15 packets, 6210 bytes; action:transmit
exceeded 5 packets, 5070 bytes; action:drop
violated 0 packets, 0 bytes; action:drop
conformed 0 bps, exceed 0 bps, violate 0 bps
Class-map:class-default (match-any)
105325 packets, 11415151 bytes
5 minute offered rate 0 bps, drop rate 0 bps
Table 174 describes the significant fields shown in the display.
Table 174 show policy-map control-plane Field Descriptions
Field
|
Description
|
Fields Associated with Classes or Service Policies
|
Service-policy input
|
Name of the input service policy that is applied to the control plane. (This field will also show the output service policy, if configured.)
|
Class-map
|
Class of traffic being displayed. Traffic is displayed for each configured class. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
offered rate
|
Rate, in kbps, at which packets are coming into the class.
|
drop rate
|
Rate, in kbps, at which packets are dropped from the class. The drop rate is calculated by subtracting the number of successfully transmitted packets from the offered rate.
|
Match
|
Match criteria for the specified class of traffic.
For more information about the variety of match criteria options available, see the "Applying QoS Features Using the MQC" module in the Cisco IOS Quality of Service Solutions Configuration Guide.
|
Fields Associated with Traffic Policing
|
police
|
Indicates that the police command has been configured to enable traffic policing.
|
conformed
|
Displays the action to be taken on packets that conform to a specified rate. Displays the number of packets and bytes on which the action was taken.
|
exceeded
|
Displays the action to be taken on packets that exceed a specified rate. Displays the number of packets and bytes on which the action was taken.
|
violated
|
Displays the action to be taken on packets that violate a specified rate. Displays the number of packets and bytes on which the action was taken.
|
Related Commands
Command
|
Description
|
control-plane
|
Enters control-plane configuration mode to apply a QoS policy to police traffic destined for the control plane.
|
service-policy (control-plane)
|
Attaches a policy map to the control plane for aggregate or distributed control-plane services.
|
show policy-map interface
To display the statistics and the configurations of the input and output policies that are attached to an interface, use the show policy-map interface command in user EXEC or privileged EXEC mode.
Cisco 3660, 3845, 7200, 7400, 7500, and ASR 1000 Series Routers
show policy-map interface [type access-control] type number [vc [vpi/] vci] [dlci dlci]
[input | output]
ATM Shared Port Adapters
show policy-map interface slot/subslot/port[.subinterface]
Cisco 7600 Series Routers
show policy-map interface [interface-type interface-number | null 0 | vlan vlan-id]
[input | output]
Cisco 6500 Series Switches
show policy-map interface [interface-type interface-number | vlan vlan-id] [detailed]
[{input | output} [class class-name]]
show policy-map interface [port-channel channel-number [class class-name]]
Syntax Description
type access-control
|
(Optional) Displays class maps configured to determine the exact pattern to look for in the protocol stack of interest.
|
type
|
Type of interface or subinterface whose policy configuration is to be displayed.
|
number
|
Port, connector, or interface card number.
|
vc
|
(Optional) For ATM interfaces only, shows the policy configuration for a specified PVC.
|
vpi/
|
(Optional) ATM network virtual path identifier (VPI) for this permanent virtual circuit (PVC). On the Cisco 7200 and 7500 series routers, this value ranges from 0 to 255.
The vpi and vci arguments cannot both be set to 0; if one is 0, the other cannot be 0.
The absence of both the forward slash (/) and a vpi value defaults the vpi value to 0. If this value is omitted, information for all virtual circuits (VCs) on the specified ATM interface or subinterface is displayed.
|
vci
|
(Optional) ATM network virtual channel identifier (VCI) for this PVC. This value ranges from 0 to 1 less than the maximum value set for this interface by the atm vc-per-vp command. Typically, the lower values 0 to 31 are reserved for specific traffic (F4 Operation, Administration, and Maintenance [OAM], switched virtual circuit [SVC] signaling, Integrated Local Management Interface [ILMI], and so on) and should not be used.
The VCI is a 16-bit field in the header of the ATM cell. The VCI value is unique only on a single link, not throughout the ATM network, because it has local significance only.
The vpi and vci arguments cannot both be set to 0; if one is 0, the other cannot be 0.
|
dlci
|
(Optional) Indicates a specific PVC for which policy configuration will be displayed.
|
dlci
|
(Optional) A specific data-link connection identifier (DLCI) number used on the interface. Policy configuration for the corresponding PVC will be displayed when a DLCI is specified.
|
input
|
(Optional) Indicates that the statistics for the attached input policy will be displayed.
|
output
|
(Optional) Indicates that the statistics for the attached output policy will be displayed.
|
slot
|
(ATM shared port adapter only) Chassis slot number. See the appropriate hardware manual for slot information. For SIPs, see the platform-specific SPA hardware installation guide or the corresponding "Identifying Slots and Subslots for SIPs and SPAs" topic in the platform-specific SPA software configuration guide.
|
/subslot
|
(ATM shared port adapter only) Secondary slot number on an SPA interface processor (SIP) where a SPA is installed. See the platform-specific SPA hardware installation guide and the corresponding "Specifying the Interface Address on an SPA" topic in the platform-specific SPA software configuration guide for subslot information.
|
/port
|
(ATM shared port adapter only) Port or interface number. See the appropriate hardware manual for port information. For SPAs, see the corresponding "Specifying the Interface Address" topics in the platform-specific SPA software configuration guide.
|
.subinterface
|
(ATM shared port adapter only—Optional) Subinterface number. The number that precedes the period must match the number to which this subinterface belongs. The range is 1 to 4,294,967,293.
|
interface-type
|
(Optional) Interface type; possible valid values are ethernet, fastethernet, gigabitethernet, tengigabitethernet, pos, atm, and ge-wan.
|
interface-number
|
(Optional) Module and port number; see the "Usage Guidelines" section for valid values.
|
null 0
|
(Optional) Specifies the null interface; the only valid value is 0.
|
vlan vlan-id
|
(Optional) Specifies the VLAN ID; valid values are from 1 to 4094.
|
detailed
|
(Optional) Displays additional statistics.
|
class class-name
|
(Optional) Displays the QoS policy actions for the specified class.
|
port-channel channel-number
|
(Optional) Displays the EtherChannel port-channel interface.
|
Command Default
This command displays the packet statistics of all classes that are configured for all service policies on the specified interface or subinterface or on a specific permanent virtual circuit (PVC) on the interface.
The absence of both the forward slash (/) and a vpi value defaults the vpi value to 0. If this value is omitted, information for all virtual circuits (VCs) on the specified ATM interface or subinterface is displayed.
ATM Shared Port Adapter
When used with the ATM shared port adapter, this command has no default behavior or values.
Command Modes
Privileged EXEC (#)
ATM Shared Port Adapter
User EXEC (>)
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.0(5)T
|
This command was introduced.
|
12.0(5)XE
|
This command was integrated into Cisco IOS Release 12.0(5)XE.
|
12.0(7)S
|
This command was integrated into Cisco IOS Release 12.0(7)S.
|
12.0(28)S
|
This command was modified for the QoS: Percentage-Based Policing feature to include milliseconds when calculating the committed (conform) burst (bc) and excess (peak) burst (be) sizes.
|
12.1(1)E
|
This command was integrated into Cisco IOS Release 12.1(1)E.
|
12.1(2)T
|
This command was modified to display information about the policy for all Frame Relay PVCs on the interface or, if a DLCI is specified, the policy for that specific PVC. This command was also modified to display the total number of packets marked by the quality of service (QoS) set action.
|
12.1(3)T
|
This command was modified to display per-class accounting statistics.
|
12.2(4)T
|
This command was modified for two-rate traffic policing and can display burst parameters and associated actions.
|
12.2(8)T
|
The command was modified for the Policer Enhancement—Multiple Actions feature and the WRED—Explicit Congestion Notification (ECN) feature.
For the Policer Enhancement—Multiple Actions feature, the command was modified to display the multiple actions configured for packets conforming to, exceeding, or violating a specific rate.
For the WRED—Explicit Congestion Notification (ECN) feature, the command displays ECN marking information.
|
12.2(13)T
|
The following modifications were made:
• This command was modified for the Percentage-Based Policing and Shaping feature.
• This command was modified for the Class-Based RTP and TCP Header Compression feature.
• This command was modified as part of the Modular QoS CLI (MQC) Unconditional Packet Discard feature. Traffic classes in policy maps can now be configured to discard packets belonging to a specified class.
• This command was modified to display the Frame Relay DLCI number as a criterion for matching traffic inside a class map.
• This command was modified to display Layer 3 packet length as a criterion for matching traffic inside a class map.
• This command was modified for the Enhanced Packet Marking feature. A mapping table (table map) can now be used to convert and propagate packet-marking values.
|
12.2(14)SX
|
Support for this command was introduced on Cisco 7600 series routers.
|
12.2(15)T
|
This command was modified to display Frame Relay voice-adaptive traffic-shaping information.
|
12.2(17d)SXB
|
This command was implemented on the Supervisor Engine 2 and integrated into Cisco IOS Release 12.2(17d)SXB.
|
12.3(14)T
|
This command was modified to display bandwidth estimation parameters.
|
12.2(18)SXE
|
This command was integrated into Cisco IOS Release 12.2(18)SXE. This command was modified to display aggregate WRED statistics for the ATM shared port adapter. Note that changes were made to the syntax, defaults, and command modes. These changes are labelled "ATM Shared Port Adapter."
|
12.4(4)T
|
The type access-control keywords were added to support flexible packet matching.
|
12.2(28)SB
|
This command was integrated into Cisco IOS Release 12.2(28)SB, and the following modifications were made:
• This command was modified to display either legacy (undistributed processing) QoS or hierarchical queueing framework (HQF) parameters on Frame Relay interfaces or PVCs.
• This command was modified to display information about Layer 2 Tunnel Protocol Version 3 (L2TPv3) tunnel marking.
|
12.2(31)SB2
|
The following modifications were made:
• This command was enhanced to display statistical information for each level of priority service configured and information about bandwidth-remaining ratios, and this command was implemented on the Cisco 10000 series router for the PRE3.
• This command was modified to display statistics for matching packets on the basis of VLAN identification numbers. As of Cisco IOS Release 12.2(31)SB2, matching packets on the basis of VLAN identification numbers is supported on Cisco 10000 series routers only.
|
12.2(33)SRC
|
This command was integrated into Cisco IOS Release 12.2(33)SRC.
|
12.4(15)T2
|
This command was modified to display information about Generic Routing Encapsulation (GRE) tunnel marking.
Note As of this release, GRE-tunnel marking is supported on the Cisco MGX Route Processor Module (RPM-XF) platform only.
|
12.2(33)SB
|
This command was modified to display information about GRE-tunnel marking, and support for the Cisco 7300 series router was added.
|
Cisco IOS XE 2.1
|
This command was integrated into Cisco IOS XE Release 2.1 and was implemented on the Cisco ASR 1000 series router.
|
12.4(20)T
|
This command was modified. Support was added for hierarchical queueing framework (HQF) using the Modular Quality of Service (QoS) Command-Line Interface (CLI) (MQC) and the packets delayed and the bytes delayed counters were removed for traffic shaping classes.
|
12.2(33)SXI
|
This command was implemented on the Catalyst 6500 series switch and modified to display the strict level in the priority feature and the counts per level.
|
Usage Guidelines
Cisco 3660, 3845, 7200, 7400, 7500, and ASR 1000 Series Routers
The show policy-map interface command displays the packet statistics for classes on the specified interface or the specified PVC only if you attach a service policy to the interface or the PVC.
The counters displayed after you enter the show policy-map interface command are updated only if congestion is present on the interface.
The show policy-map interface command displays policy information about Frame Relay PVCs only if you enable Frame Relay Traffic Shaping (FRTS) on the interface.
The show policy-map interface command displays ECN marking information only if you enable ECN on the interface.
To determine if shaping is active with HQF, check the queue depth field of the "(queue depth/total drops/no-buffer drops)" line in the show policy-map interface command output.
In HQF images for Cisco IOS Releases 12.4(20)T and later, the packets delayed and the bytes delayed counters were removed for traffic shaping classes.
Cisco 7600 Series Routers and Catalyst 6500 Series Switches
The pos, atm, and ge-wan interfaces are not supported on Cisco 7600 series routers or Catalyst 6500 series switches that are configured with a Supervisor Engine 720.
Cisco 7600 series routers and Catalyst 6500 series switches that are configured with a Supervisor Engine 2 display packet counters.
Cisco 7600 series routers and Catalyst 6500 series switches that are configured with a Supervisor Engine 720 display byte counters.
The output does not display policed-counter information; 0 is displayed in its place (for example, 0 packets, 0 bytes). To display dropped and forwarded policed-counter information, enter the show mls qos command.
On the Cisco 7600 series router, for OSM WAN interfaces only, if you configure policing within a policy map, the hardware counters are displayed and the class-default counters are not displayed. If you do not configure policing within a policy map, the class-default counters are displayed.
On the Catalyst 6500 series switch, the show policy-map interface command displays the strict level in the priority feature and the counts per level.
The interface-number argument designates the module and port number. Valid values for interface-number depend on the specified interface type and the chassis and module that are used. For example, if you specify a Gigabit Ethernet interface and have a 48-port 10/100BASE-T Ethernet module that is installed in a 13-slot chassis, valid values for the module number are from 1 to 13 and valid values for the port number are from 1 to 48.
HQF
When you configure HQF, the show policy-map interface command displays additional fields that include the differentiated services code point (DSCP) value, WRED statistics in bytes, transmitted packets by WRED, and a counter that displays packets output/bytes output in each class.
Examples
This section provides sample output from typical show policy-map interface commands. Depending upon the interface or platform in use and the options enabled, the output you see may vary slightly from the ones shown below.
•
Weighted Fair Queueing (WFQ) on Serial Interface: Example
•
Traffic Shaping on Serial Interface: Example
•
Precedence-Based Aggregate WRED on ATM Shared Port Adapter: Example
•
DSCP-Based Aggregate WRED on ATM Shared Port Adapter: Example
•
Frame Relay Voice-Adaptive Traffic-Shaping: Example
•
Two-Rate Traffic Policing: Example
•
Multiple Traffic Policing Actions: Example
•
Explicit Congestion Notification: Example
•
Class-Based RTP and TCP Header Compression: Example
•
Modular QoS CLI (MQC) Unconditional Packet Discard: Example
•
Percentage-Based Policing and Shaping: Example
•
Traffic Shaping: Example
•
Packet Classification Based on Layer 3 Packet Length: Example
•
Enhanced Packet Marking: Example
•
Traffic Policing: Example
•
Formula for Calculating the CIR: Example
•
Formula for Calculating the PIR: Example
•
Formula for Calculating the Committed Burst (bc): Example
•
Formula for Calculating the Excess Burst (be): Example
•
Bandwidth Estimation: Example
•
Shaping with HQF Enabled: Example
•
Packets Matched on the Basis of VLAN ID Number: Example
•
Cisco 7600 Series Routers: Example
•
Multiple Priority Queues on Serial Interface: Example
•
Bandwidth-Remaining Ratios: Example
•
Tunnel Marking: Example
•
Traffic Shaping Overhead Accounting for ATM: Example
•
HQF: Example
Weighted Fair Queueing (WFQ) on Serial Interface: Example
The following sample output of the show policy-map interface command displays the statistics for the serial 3/1 interface, to which a service policy called mypolicy (configured as shown below) is attached. Weighted fair queueing (WFQ) has been enabled on this interface. See Table 175 for an explanation of the significant fields that commonly appear in the command output.
Router# show policy-map interface serial3/1 output
Service-policy output: mypolicy
Class-map: voice (match-all)
5 minute offered rate 0 bps, drop rate 0 bps
Output Queue: Conversation 264
Bandwidth 128 (kbps) Burst 3200 (Bytes)
(pkts matched/bytes matched) 0/0
(total drops/bytes drops) 0/0
Class-map: gold (match-all)
5 minute offered rate 0 bps, drop rate 0 bps
Output Queue: Conversation 265
Bandwidth 100 (kbps) Max Threshold 64 (packets)
(pkts matched/bytes matched) 0/0
(depth/total drops/no-buffer drops) 0/0/0
Class-map: silver (match-all)
5 minute offered rate 0 bps, drop rate 0 bps
Output Queue: Conversation 266
(pkts matched/bytes matched) 0/0
(depth/total drops/no-buffer drops) 0/0/0
class Transmitted Random drop Tail drop Minimum Maximum Mark
pkts/bytes pkts/bytes pkts/bytes thresh thresh prob
rsvp 0/0 0/0 0/0 36 40 1/10
Class-map: class-default (match-any)
5 minute offered rate 0 bps, drop rate 0 bps
Traffic Shaping on Serial Interface: Example
The following sample output from the show policy-map interface command displays the statistics for the serial 3/2 interface, to which a service policy called p1 (configured as shown below) is attached. Traffic shaping has been enabled on this interface. See Table 175 for an explanation of the significant fields that commonly appear in the command output.
Note
In HQF images for Cisco IOS Releases 12.4(20)T and later, the packets delayed and bytes delayed counters were removed for traffic shaping classes.
Router# show policy-map interface serial3/2 output
Service-policy output: p1
Class-map: c1 (match-all)
5 minute offered rate 0 bps, drop rate 0 bps
Target Byte Sustain Excess Interval Increment Adapt
Rate Limit bits/int bits/int (ms) (bytes) Active
320000 2000 8000 8000 25 1000 -
Queue Packets Bytes Packets Bytes Shaping
Depth Delayed Delayed Active
Class-map: class-default (match-any)
5 minute offered rate 0 bps, drop rate 0 bps
Table 175 describes significant fields commonly shown in the displays. The fields in the table are grouped according to the relevant QoS feature.
Table 175 show policy-map interface Field Descriptions1
Field
|
Description
|
Fields Associated with Classes or Service Policies
|
Service-policy output
|
Name of the output service policy applied to the specified interface or VC.
|
Class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets and bytes
|
Number of packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
offered rate
|
Rate, in kbps, of packets coming in to the class.
Note If the packets are compressed over an outgoing interface, the improved packet rate achieved by packet compression is not reflected in the offered rate. Also, if the packets are classified before they enter a combination of tunnels (for example, a generic routing encapsulation (GRE) tunnel and an IP Security (IPSec) tunnel), the offered rate does not include all the extra overhead associated with tunnel encapsulation in general. Depending on the configuration, the offered rate may include no overhead, may include the overhead for only one tunnel encapsulation, or may include the overhead for all tunnel encapsulations. In most of the GRE and IPSec tunnel configurations, the offered rate includes the overhead for GRE tunnel encapsulation only.
|
drop rate
|
Rate, in kbps, at which packets are dropped from the class. The drop rate is calculated by subtracting the number of successfully transmitted packets from the offered rate.
|
Note In distributed architecture platforms (such as the Cisco 7500 series platform), the value of the transfer rate, calculated as the difference between the offered rate and the drop rate counters, can sporadically deviate from the average by up to 20 percent or more. This can occur while no corresponding burst is registered by independent traffic analyser equipment.
|
Match
|
Match criteria specified for the class of traffic. Choices include criteria such as IP precedence, IP differentiated services code point (DSCP) value, Multiprotocol Label Switching (MPLS) experimental (EXP) value, access groups, and QoS groups. For more information about the variety of match criteria that are available, see the "Classifying Network Traffic" module in the Cisco IOS Quality of Service Solutions Configuration Guide.
|
Fields Associated with Queueing (if Enabled)
|
Output Queue
|
The weighted fair queueing (WFQ) conversation to which this class of traffic is allocated.
|
Bandwidth
|
Bandwidth, in either kbps or percentage, configured for this class and the burst size.
|
pkts matched/bytes matched
|
Number of packets (also shown in bytes) matching this class that were placed in the queue. This number reflects the total number of matching packets queued at any time. Packets matching this class are queued only when congestion exists. If packets match the class but are never queued because the network was not congested, those packets are not included in this total. However, if process switching is in use, the number of packets is always incremented even if the network is not congested.
|
depth/total drops/no-buffer drops
|
Number of packets discarded for this class. No-buffer indicates that no memory buffer exists to service the packet.
|
Fields Associated with Weighted Random Early Detection (WRED) (if Enabled)
|
exponential weight
|
Exponent used in the average queue size calculation for a WRED parameter group.
|
mean queue depth
|
Average queue depth based on the actual queue depth on the interface and the exponential weighting constant. It is a fluctuating average. The minimum and maximum thresholds are compared against this value to determine drop decisions.
|
class
|
IP precedence level.
|
Transmitted pkts/bytes
|
Number of packets (also shown in bytes) passed through WRED and not dropped by WRED.
Note If there is insufficient memory in the buffer to accommodate the packet, the packet can be dropped after the packet passes through WRED. Packets dropped because of insufficient memory in the buffer (sometimes referred to as "no-buffer drops") are not taken into account by the WRED packet counter.
|
Random drop pkts/bytes
|
Number of packets (also shown in bytes) randomly dropped when the mean queue depth is between the minimum threshold value and the maximum threshold value for the specified IP precedence level.
|
Tail drop pkts/bytes
|
Number of packets dropped when the mean queue depth is greater than the maximum threshold value for the specified IP precedence level.
|
Minimum thresh
|
Minimum threshold. Minimum WRED threshold in number of packets.
|
Maximum thresh
|
Maximum threshold. Maximum WRED threshold in number of packets.
|
Mark prob
|
Mark probability. Fraction of packets dropped when the average queue depth is at the maximum threshold.
|
Fields Associated with Traffic Shaping (if Enabled)
|
Target Rate
|
Rate used for shaping traffic.
|
Byte Limit
|
Maximum number of bytes that can be transmitted per interval. Calculated as follows:
((Bc+Be) /8) x 1
|
Sustain bits/int
|
Committed burst (Bc) rate.
|
Excess bits/int
|
Excess burst (Be) rate.
|
Interval (ms)
|
Time interval value in milliseconds (ms).
|
Increment (bytes)
|
Number of credits (in bytes) received in the token bucket of the traffic shaper during each time interval.
|
Queue Depth
|
Current queue depth of the traffic shaper.
|
Packets
|
Total number of packets that have entered the traffic shaper system.
|
Bytes
|
Total number of bytes that have entered the traffic shaper system.
|
Packets Delayed
|
Total number of packets delayed in the queue of the traffic shaper before being transmitted.
Note This counter was removed in Cisco IOS Release 12.4(20)T.
|
Bytes Delayed
|
Total number of bytes delayed in the queue of the traffic shaper before being transmitted.
Note This counter was removed in Cisco IOS Release 12.4(20)T.
|
Shaping Active
|
Indicates whether the traffic shaper is active. For example, if a traffic shaper is active, and the traffic being sent exceeds the traffic shaping rate, a "yes" appears in this field.
|
Precedence-Based Aggregate WRED on ATM Shared Port Adapter: Example
The following sample output of the show policy-map interface command displays the statistics for the ATM shared port adapter interface 4/1/0.10, to which a service policy called prec-aggr-wred (configured as shown below) is attached. Because aggregate WRED has been enabled on this interface, the class through Mark Prob statistics are aggregated by subclasses. See Table 176 for an explanation of the significant fields that commonly appear in the command output.
Router(config)# policy-map prec-aggr-wred
Router(config-pmap)# class class-default
Router(config-pmap-c)# random-detect aggregate
Router(config-pmap-c)# random-detect precedence values 0 1 2 3 minimum thresh 10
maximum-thresh 100 mark-prob 10
Router(config-pmap-c)# random-detect precedence values 4 5 minimum-thresh 40
maximum-thresh 400 mark-prob 10
Router(config-pmap-c)# random-detect precedence values 6 minimum-thresh 60 maximum-thresh
600 mark-prob 10
Router(config-pmap-c)# random-detect precedence values 7 minimum-thresh 70 maximum-thresh
700 mark-prob 10
Router(config-pmap-c)# exit
Router(config-pmap)# exit
Router(config)# interface ATM4/1/0.10 point-to-point
Router(config-if)# ip address 10.0.0.2 255.255.255.0
Router(config-if)# pvc 10/110
Router(config-if)# service-policy output prec-aggr-wred
Router# show policy-map interface atm4/1/0.10
Service-policy output: prec-aggr-wred
Class-map: class-default (match-any)
5 minute offered rate 0 bps, drop rate 0 bps
Exp-weight-constant: 9 (1/512)
class Transmitted Random drop Tail drop Minimum Maximum Mark
pkts/bytes pkts/bytes pkts/bytes thresh thresh prob
0 1 2 3 0/0 0/0 0/0 10 100 1/10
4 5 0/0 0/0 0/0 40 400 1/10
6 0/0 0/0 0/0 60 600 1/10
7 0/0 0/0 0/0 70 700 1/10
DSCP-Based Aggregate WRED on ATM Shared Port Adapter: Example
The following sample output of the show policy-map interface command displays the statistics for the ATM shared port adapter interface 4/1/0.11, to which a service policy called dscp-aggr-wred (configured as shown below) is attached. Because aggregate WRED has been enabled on this interface, the class through Mark Prob statistics are aggregated by subclasses. See Table 176 for an explanation of the significant fields that commonly appear in the command output.
Router(config)# policy-map dscp-aggr-wred
Router(config-pmap)# class class-default
Router(config-pmap-c)# random-detect dscp-based aggregate minimum-thresh 1 maximum-thresh
10 mark-prob 10
Router(config-pmap-c)# random-detect dscp values 0 1 2 3 4 5 6 7 minimum-thresh 10
maximum-thresh 20 mark-prob 10
Router(config-pmap-c)# random-detect dscp values 8 9 10 11 minimum-thresh 10
maximum-thresh 40 mark-prob 10
Router(config-pmap-c)# exit
Router(config-pmap)# exit
Router(config)# interface ATM4/1/0.11 point-to-point
Router(config-subif)# ip address 10.0.0.2 255.255.255.0
Router(config-subif)# pvc 11/101
Router(config-subif)# service-policy output dscp-aggr-wred
Router# show policy-map interface atm4/1/0.11
Service-policy output: dscp-aggr-wred
Class-map: class-default (match-any)
5 minute offered rate 0 bps, drop rate 0 bps
Exp-weight-constant: 0 (1/1)
class Transmitted Random drop Tail drop Minimum Maximum Mark
pkts/bytes pkts/bytes pkts/bytes thresh thresh prob
default 0/0 0/0 0/0 1 10 1/10
4 5 6 7 0/0 0/0 0/0 10 20 1/10
8 9 10 11 0/0 0/0 0/0 10 40 1/10
Table 176 describes the significant fields shown in the display when aggregate WRED is configured for an ATM shared port adapter.
Table 176 show policy-map interface Field Descriptions—Configured for Aggregate WRED on ATM Shared Port Adapter
Field
|
Description
|
exponential weight
|
Exponent used in the average queue size calculation for a Weighted Random Early Detection (WRED) parameter group.
|
mean queue depth
|
Average queue depth based on the actual queue depth on the interface and the exponential weighting constant. It is a fluctuating average. The minimum and maximum thresholds are compared against this value to determine drop decisions.
|
Note When Aggregate Weighted Random Early Detection (WRED) is enabled, the following WRED statistics will be aggregated based on their subclass (either their IP precedence or differentiated services code point (DSCP) value).
|
class
|
IP precedence level or differentiated services code point (DSCP) value.
|
Transmitted pkts/bytes
|
Number of packets (also shown in bytes) passed through WRED and not dropped by WRED.
Note If there is insufficient memory in the buffer to accommodate the packet, the packet can be dropped after the packet passes through WRED. Packets dropped because of insufficient memory in the buffer (sometimes referred to as "no-buffer drops") are not taken into account by the WRED packet counter.
|
Random drop pkts/bytes
|
Number of packets (also shown in bytes) randomly dropped when the mean queue depth is between the minimum threshold value and the maximum threshold value for the specified IP precedence level or DSCP value.
|
Tail drop pkts/bytes
|
Number of packets dropped when the mean queue depth is greater than the maximum threshold value for the specified IP precedence level or DSCP value.
|
Minimum thresh
|
Minimum threshold. Minimum WRED threshold in number of packets.
|
Maximum thresh
|
Maximum threshold. Maximum WRED threshold in number of packets.
|
Mark prob
|
Mark probability. Fraction of packets dropped when the average queue depth is at the maximum threshold.
|
Frame Relay Voice-Adaptive Traffic-Shaping: Example
The following sample output shows that Frame Relay voice-adaptive traffic shaping is currently active and has 29 seconds left on the deactivation timer. With traffic shaping active and the deactivation time set, this means that the current sending rate on DLCI 201 is minCIR, but if no voice packets are detected for 29 seconds, the sending rate will increase to CIR.
Note
In HQF images for Cisco IOS Releases 12.4(20)T and later, the packets delayed and bytes delayed counters were removed for traffic shaping classes.
Router# show policy interface Serial3/1.1
Service-policy output:MQC-SHAPE-LLQ1
Class-map:class-default (match-any)
1434 packets, 148751 bytes
30 second offered rate 14000 bps, drop rate 0 bps
Target/Average Byte Sustain Excess Interval Increment
Rate Limit bits/int bits/int (ms) (bytes)
63000/63000 1890 7560 7560 120 945
Adapt Queue Packets Bytes Packets Bytes Shaping
Active Depth Delayed Delayed Active
BECN 0 1434 162991 26 2704 yes
Voice Adaptive Shaping active, time left 29 secs
Table 177 describes the significant fields shown in the display. Significant fields that are not described in Table 177 are described in Table 175, "show policy-map interface Field Descriptions."
Table 177 show policy-map interface Field Descriptions—Configured for Frame Relay Voice-Adaptive Traffic Shaping
Field
|
Description
|
Voice Adaptive Shaping active/inactive
|
Indicates whether Frame Relay voice-adaptive traffic shaping is active or inactive.
|
time left
|
Number of seconds left on the Frame Relay voice-adaptive traffic shaping deactivation timer.
|
Two-Rate Traffic Policing: Example
The following is sample output from the show policy-map interface command when two-rate traffic policing has been configured. In the example below, 1.25 Mbps of traffic is sent ("offered") to a policer class.
Router# show policy-map interface serial3/0
Service-policy output: policy1
Class-map: police (match all)
148803 packets, 36605538 bytes
30 second offered rate 1249000 bps, drop rate 249000 bps
cir 500000 bps, conform-burst 10000, pir 1000000, peak-burst 100000
conformed 59538 packets, 14646348 bytes; action: transmit
exceeded 59538 packets, 14646348 bytes; action: set-prec-transmit 2
violated 29731 packets, 7313826 bytes; action: drop
conformed 499000 bps, exceed 500000 bps violate 249000 bps
Class-map: class-default (match-any)
30 seconds offered rate 0 bps, drop rate 0 bps
The two-rate traffic policer marks 500 kbps of traffic as conforming, 500 kbps of traffic as exceeding, and 250 kbps of traffic as violating the specified rate. Packets marked as conforming will be sent as is, and packets marked as exceeding will be marked with IP Precedence 2 and then sent. Packets marked as violating the specified rate are dropped.
Table 178 describes the significant fields shown in the display.
Table 178 show policy-map interface Field Descriptions—Configured for Two-Rate Traffic Policing
Field
|
Description
|
police
|
Indicates that the police command has been configured to enable traffic policing. Also, displays the specified CIR, conform burst size, peak information rate (PIR), and peak burst size used for marking packets.
|
conformed
|
Displays the action to be taken on packets conforming to a specified rate. Displays the number of packets and bytes on which the action was taken.
|
exceeded
|
Displays the action to be taken on packets exceeding a specified rate. Displays the number of packets and bytes on which the action was taken.
|
violated
|
Displays the action to be taken on packets violating a specified rate. Displays the number of packets and bytes on which the action was taken.
|
Multiple Traffic Policing Actions: Example
The following is sample output from the show policy-map command when the Policer Enhancement—Multiple Actions feature has been configured. The sample output from the show policy-map interface command displays the statistics for the serial 3/2 interface, to which a service policy called "police" (configured as shown below) is attached.
police cir 1000000 pir 2000000
exceed-action set-prec-transmit 4
exceed-action set-frde-transmit
violate-action set-prec-transmit 2
violate-action set-frde-transmit
Router# show policy-map interface serial3/2
Service-policy output: police
Class-map: class-default (match-any)
172984 packets, 42553700 bytes
5 minute offered rate 960000 bps, drop rate 277000 bps
cir 1000000 bps, bc 31250 bytes, pir 2000000 bps, be 31250 bytes
conformed 59679 packets, 14680670 bytes; actions:
exceeded 59549 packets, 14649054 bytes; actions:
violated 53758 packets, 13224468 bytes; actions:
conformed 340000 bps, exceed 341000 bps, violate 314000 bps
The sample output from show policy-map interface command shows the following:
•
59679 packets were marked as conforming packets (that is, packets conforming to the CIR) and were transmitted unaltered.
•
59549 packets were marked as exceeding packets (that is, packets exceeding the CIR but not exceeding the PIR). Therefore, the IP Precedence value of these packets was changed to an IP Precedence level of 4, the discard eligibility (DE) bit was set to 1, and the packets were transmitted with these changes.
•
53758 packets were marked as violating packets (that is, exceeding the PIR). Therefore, the IP Precedence value of these packets was changed to an IP Precedence level of 2, the DE bit was set to 1, and the packets were transmitted with these changes.
Note
Actions are specified by using the action argument of the police command. For more information about the available actions, see the police command reference page.
Table 179 describes the significant fields shown in the display.
Table 179 show policy-map interface Field Descriptions—Configured for Multiple Traffic Policing Actions
Field
|
Description
|
police
|
Indicates that the police command has been configured to enable traffic policing. Also, displays the specified CIR, conform burst size (BC), PIR, and peak burst size (BE) used for marking packets.
|
conformed, packets, bytes, actions
|
Displays the number of packets (also shown in bytes) marked as conforming to a specified rate and the actions taken on the packet. If there are multiple actions, each action is listed separately.
|
exceeded, packets, bytes, actions
|
Displays the number of packets (also shown in bytes) marked as exceeding a specified rate and the actions taken on the packet. If there are multiple actions, each action is listed separately.
|
violated, packets, bytes, actions
|
Displays the number of packets (also shown in bytes) marked as violating a specified rate and the actions taken on the packet. If there are multiple actions, each action is listed separately.
|
Explicit Congestion Notification: Example
The following is sample output from the show policy-map interface command when the WRED — Explicit Congestion Notification (ECN) feature has been configured. The words "explicit congestion notification" included in the output indicate that ECN has been enabled.
Router# show policy-map interface Serial4/1
Service-policy output:policy_ecn
Class-map:prec1 (match-all)
1000 packets, 125000 bytes
30 second offered rate 14000 bps, drop rate 5000 bps
Output Queue:Conversation 42
(pkts matched/bytes matched) 989/123625
(depth/total drops/no-buffer drops) 0/455/0
explicit congestion notification
class Transmitted Random drop Tail drop Minimum Maximum Mark
pkts/bytes pkts/bytes pkts/bytes threshold threshold probability
1 545/68125 0/0 0/0 22 40 1/10
rsvp 0/0 0/0 0/0 36 40 1/10
Table 180 describes the significant fields shown in the display.
Table 180 show policy-map interface Field Descriptions—Configured for ECN
Field
|
Description
|
explicit congestion notification
|
Indication that Explicit Congestion Notification is enabled.
|
mean queue depth
|
Average queue depth based on the actual queue depth on the interface and the exponential weighting constant. It is a moving average. The minimum and maximum thresholds are compared against this value to determine drop decisions.
|
class
|
IP precedence value.
|
Transmitted pkts/bytes
|
Number of packets (also shown in bytes) passed through WRED and not dropped by WRED.
Note If there is insufficient memory in the buffer to accommodate the packet, the packet can be dropped after the packet passes through WRED. Packets dropped because of insufficient memory in the buffer (sometimes referred to as "no-buffer drops") are not taken into account by the WRED packet counter.
|
Random drop pkts/bytes
|
Number of packets (also shown in bytes) randomly dropped when the mean queue depth is between the minimum threshold value and the maximum threshold value for the specified IP precedence value.
|
Tail drop pkts/bytes
|
Number of packets dropped when the mean queue depth is greater than the maximum threshold value for the specified IP precedence value.
|
Minimum threshold
|
Minimum WRED threshold in number of packets.
|
Maximum threshold
|
Maximum WRED threshold in number of packets.
|
Mark probability
|
Fraction of packets dropped when the average queue depth is at the maximum threshold.
|
ECN Mark pkts/bytes
|
Number of packets (also shown in bytes) marked by ECN.
|
Class-Based RTP and TCP Header Compression: Example
The following sample output from the show policy-map interface command shows the RTP header compression has been configured for a class called "prec2" in the policy map called "p1".
The show policy-map interface command output displays the type of header compression configured (RTP), the interface to which the policy map called "p1" is attached (Serial 4/1), the total number of packets, the number of packets compressed, the number of packets saved, the number of packets sent, and the rate at which the packets were compressed (in bits per second (bps)).
In this example, User Datagram Protocol (UDP)/RTP header compressions have been configured, and the compression statistics are included at the end of the display.
Router# show policy-map interface Serial4/1
Class-map:class-default (match-any)
1005 packets, 64320 bytes
30 second offered rate 16000 bps, drop rate 0 bps
Sent:1000 total, 999 compressed,
41957 bytes saved, 17983 bytes sent
3.33 efficiency improvement factor
99% hit ratio, five minute miss rate 0 misses/sec, 0 max
Table 181 describes the significant fields shown in the display.
Table 181 show policy-map interface Field Descriptions—Configured for Class-Based RTP and TCP Header Compression1
Field
|
Description
|
Service-policy output
|
Name of the output service policy applied to the specified interface or VC.
|
Class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets, bytes
|
Number of packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
offered rate
|
Rate, in kbps, of packets coming in to the class.
Note If the packets are compressed over an outgoing interface, the improved packet rate achieved by packet compression is not reflected in the offered rate. Also, if the packets are classified before they enter a combination of tunnels (for example, a generic routing encapsulation (GRE) tunnel and an IP Security (IPSec) tunnel), the offered rate does not include all the extra overhead associated with tunnel encapsulation in general. Depending on the configuration, the offered rate may include no overhead, may include the overhead for only one tunnel encapsulation, or may include the overhead for all tunnel encapsulations. In most of the GRE and IPSec tunnel configurations, the offered rate includes the overhead for GRE tunnel encapsulation only.
|
UDP/RTP Compression
|
Indicates that RTP header compression has been configured for the class.
|
Sent total
|
Count of every packet sent, both compressed packets and full-header packets.
|
Sent compressed
|
Count of number of compressed packets sent.
|
bytes saved
|
Total number of bytes saved (that is, bytes not needing to be sent).
|
bytes sent
|
Total number of bytes sent for both compressed and full-header packets.
|
efficiency improvement factor
|
The percentage of increased bandwidth efficiency as a result of header compression. For example, with RTP streams, the efficiency improvement factor can be as much as 2.9 (or 290 percent).
|
hit ratio
|
Used mainly for troubleshooting purposes, this is the percentage of packets found in the context database. In most instances, this percentage should be high.
|
five minute miss rate
|
The number of new traffic flows found in the last five minutes.
|
misses/sec max
|
The average number of new traffic flows found per second, and the highest rate of new traffic flows to date.
|
rate
|
The actual traffic rate (in bits per second) after the packets are compressed.
|
Modular QoS CLI (MQC) Unconditional Packet Discard: Example
The following sample output from the show policy-map interface command displays the statistics for the Serial2/0 interface, to which a policy map called "policy1" is attached. The discarding action has been specified for all the packets belonging to a class called "c1." In this example, 32000 bps of traffic is sent ("offered") to the class and all of them are dropped. Therefore, the drop rate shows 32000 bps.
Router# show policy-map interface Serial2/0
Service-policy output: policy1
Class-map: c1 (match-all)
10184 packets, 1056436 bytes
5 minute offered rate 32000 bps, drop rate 32000 bps
Table 182 describes the significant fields shown in the display.
Table 182 show policy-map interface Field Descriptions—Configured for MQC Unconditional Packet Discard1
Field
|
Description
|
Service-policy output
|
Name of the output service policy applied to the specified interface or VC.
|
Class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets, bytes
|
Number of packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
offered rate
|
Rate, in kbps, of packets coming in to the class.
Note If the packets are compressed over an outgoing interface, the improved packet rate achieved by packet compression is not reflected in the offered rate. Also, if the packets are classified before they enter a combination of tunnels (for example, a generic routing encapsulation (GRE) tunnel and an IP Security (IPSec) tunnel), the offered rate does not include all the extra overhead associated with tunnel encapsulation in general. Depending on the configuration, the offered rate may include no overhead, may include the overhead for only one tunnel encapsulation, or may include the overhead for all tunnel encapsulations. In most of the GRE and IPSec tunnel configurations, the offered rate includes the overhead for GRE tunnel encapsulation only.
|
drop rate
|
Rate, in kbps, at which packets are dropped from the class. The drop rate is calculated by subtracting the number of successfully transmitted packets from the offered rate.
|
Note In distributed architecture platforms (such as the Cisco 7500), the value of the transfer rate, calculated as the difference between the offered rate and the drop rate counters, can sporadically deviate from the average by up to 20 percent or more. This can occur while no corresponding burst is registered by independent traffic analyser equipment.
|
Match
|
Match criteria specified for the class of traffic. Choices include criteria such as the Layer 3 packet length, IP precedence, IP DSCP value, MPLS experimental value, access groups, and QoS groups. For more information about the variety of match criteria that are available, see the "Classifying Network Traffic" module in the Cisco IOS Quality of Service Solutions Configuration Guide.
|
drop
|
Indicates that the packet discarding action for all the packets belonging to the specified class has been configured.
|
Percentage-Based Policing and Shaping: Example
The following sample output from the show policy-map interface command shows traffic policing configured using a CIR based on a bandwidth of 20 percent. The CIR and committed burst (Bc) in milliseconds (ms) are included in the display.
Router# show policy-map interface Serial3/1
Service-policy output: mypolicy
Class-map: gold (match-any)
5 minute offered rate 0 bps, drop rate 0 bps
cir 2000000 bps, bc 2500 bytes
pir 4000000 bps, be 10000 bytes
conformed 0 packets, 0 bytes; actions:
transmit
exceeded 0 packets, 0 bytes; actions:
drop
violated 0 packets, 0 bytes; actions:
conformed 0 bps, exceed 0 bps, violate 0 bps
Table 183 describes the significant fields shown in the display.
Table 183 show policy-map interface Field Descriptions—Configured for Percentage-Based Policing and Shaping1
Field
|
Description
|
Service-policy output
|
Name of the output service policy applied to the specified interface or VC.
|
Class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets, bytes
|
Number of packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
offered rate
|
Rate, in kbps, of packets coming in to the class.
Note If the packets are compressed over an outgoing interface, the improved packet rate achieved by packet compression is not reflected in the offered rate. Also, if the packets are classified before they enter a combination of tunnels (for example, a generic routing encapsulation (GRE) tunnel and an IP Security (IPSec) tunnel), the offered rate does not include all the extra overhead associated with tunnel encapsulation in general. Depending on the configuration, the offered rate may include no overhead, may include the overhead for only one tunnel encapsulation, or may include the overhead for all tunnel encapsulations. In most of the GRE and IPSec tunnel configurations, the offered rate includes the overhead for GRE tunnel encapsulation only.
|
police
|
Indicates that traffic policing based on a percentage of bandwidth has been enabled. Also, displays the bandwidth percentage, the CIR, and the committed burst (Bc) size in ms.
|
conformed, actions
|
Displays the number of packets and bytes marked as conforming to the specified rates, and the action to be taken on those packets.
|
exceeded, actions
|
Displays the number of packets and bytes marked as exceeding the specified rates, and the action to be taken on those packets.
|
Traffic Shaping: Example
The following sample output from the show policy-map interface command (shown below) displays the statistics for the serial 3/2 interface. Traffic shaping has been enabled on this interface, and an average rate of 20 percent of the bandwidth has been specified.
Note
In HQF images for Cisco IOS Releases 12.4(20)T and later, the packets delayed and bytes delayed counters were removed for traffic shaping classes.
Router# show policy-map interface Serial3/2
Service-policy output: p1
Class-map: c1 (match-all)
5 minute offered rate 0 bps, drop rate 0 bps
Target/Average Byte Sustain Excess Interval Increment Adapt
Rate Limit bits/int bits/int (ms) (bytes) Active
20 % 10 (ms) 20 (ms)
201500/201500 1952 7808 7808 38 976 -
Queue Packets Bytes Packets Bytes Shaping
Depth Delayed Delayed Active
Table 184 describes the significant fields shown in the display.
Table 184 show policy-map interface Field Descriptions—Configured for Percentage-Based Policing and Shaping (with Traffic Shaping Enabled)1
Field
|
Description
|
Service-policy output
|
Name of the output service policy applied to the specified interface or VC.
|
Class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets, bytes
|
Number of packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
offered rate
|
Rate, in kbps, of packets coming in to the class.
Note If the packets are compressed over an outgoing interface, the improved packet rate achieved by packet compression is not reflected in the offered rate. Also, if the packets are classified before they enter a combination of tunnels (for example, a generic routing encapsulation (GRE) tunnel and an IP Security (IPSec) tunnel), the offered rate does not include all the extra overhead associated with tunnel encapsulation in general. Depending on the configuration, the offered rate may include no overhead, may include the overhead for only one tunnel encapsulation, or may include the overhead for all tunnel encapsulations. In most of the GRE and IPSec tunnel configurations, the offered rate includes the overhead for GRE tunnel encapsulation only.
|
drop rate
|
Rate, in kbps, at which packets are dropped from the class. The drop rate is calculated by subtracting the number of successfully transmitted packets from the offered rate.
|
Match
|
Match criteria specified for the class of traffic. Choices include criteria such as the Layer 3 packet length, IP precedence, IP DSCP value, MPLS experimental value, access groups, and quality of service (QoS) groups. For more information about the variety of match criteria that are available, see the "Classifying Network Traffic" module in the Cisco IOS Quality of Service Solutions Configuration Guide.
|
Traffic Shaping
|
Indicates that traffic shaping based on a percentage of bandwidth has been enabled.
|
Target/Average Rate
|
Rate (percentage) used for shaping traffic and the number of packets meeting that rate.
|
Byte Limit
|
Maximum number of bytes that can be transmitted per interval. Calculated as follows:
((Bc+Be) /8 ) x 1
|
Sustain bits/int
|
Committed burst (Bc) rate.
|
Excess bits/int
|
Excess burst (Be) rate.
|
Interval (ms)
|
Time interval value in milliseconds (ms).
|
Increment (bytes)
|
Number of credits (in bytes) received in the token bucket of the traffic shaper during each time interval.
|
Adapt Active
|
Indicates whether adaptive shaping is enabled.
|
Queue Depth
|
Current queue depth of the traffic shaper.
|
Packets
|
Total number of packets that have entered the traffic shaper system.
|
Bytes
|
Total number of bytes that have entered the traffic shaper system.
|
Packets Delayed
|
Total number of packets delayed in the queue of the traffic shaper before being transmitted.
Note This counter was removed in Cisco IOS Release 12.4(20)T.
|
Bytes Delayed
|
Total number of bytes delayed in the queue of the traffic shaper before being transmitted.
Note This counter was removed in Cisco IOS Release 12.4(20)T.
|
Shaping Active
|
Indicates whether the traffic shaper is active. For example, if a traffic shaper is active, and the traffic being sent exceeds the traffic shaping rate, a "yes" appears in this field.
|
Packet Classification Based on Layer 3 Packet Length: Example
The following sample output from the show policy-map interface command displays the packet statistics for the Ethernet4/1 interface, to which a service policy called "mypolicy" is attached. The Layer 3 packet length has been specified as a match criterion for the traffic in the class called "class1".
Router# show policy-map interface Ethernet4/1
Service-policy input: mypolicy
Class-map: class1 (match-all)
500 packets, 125000 bytes
5 minute offered rate 4000 bps, drop rate 0 bps
Match: packet length min 100 max 300
Table 185 describes the significant fields shown in the display.
Table 185 show policy-map interface Field Descriptions—Configured for Packet Classification Based on Layer 3 Packet Length1
Field
|
Description
|
Service-policy input
|
Name of the input service policy applied to the specified interface or VC.
|
Class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets, bytes
|
Number of packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
offered rate
|
Rate, in kbps, of packets coming in to the class.
Note If the packets are compressed over an outgoing interface, the improved packet rate achieved by packet compression is not reflected in the offered rate. Also, if the packets are classified before they enter a combination of tunnels (for example, a generic routing encapsulation (GRE) tunnel and an IP Security (IPSec) tunnel), the offered rate does not include all the extra overhead associated with tunnel encapsulation in general. Depending on the configuration, the offered rate may include no overhead, may include the overhead for only one tunnel encapsulation, or may include the overhead for all tunnel encapsulations. In most of the GRE and IPSec tunnel configurations, the offered rate includes the overhead for GRE tunnel encapsulation only.
|
drop rate
|
Rate, in kbps, at which packets are dropped from the class. The drop rate is calculated by subtracting the number of successfully transmitted packets from the offered rate.
|
Match
|
Match criteria specified for the class of traffic. Choices include criteria such as the Layer 3 packet length, IP precedence, IP DSCP value, MPLS experimental value, access groups, and QoS groups.
|
QoS Set, qos-group, Packets marked
|
Indicates that class-based packet marking based on the QoS group has been configured. Includes the qos-group number and the number of packets marked.
|
Enhanced Packet Marking: Example
The following sample output of the show policy-map interface command shows the service policies attached to a FastEthernet subinterface. In this example, a service policy called "policy1" has been attached. In "policy1", a table map called "table-map1" has been configured. The values in "table-map1" will be used to map the precedence values to the corresponding class of service (CoS) values.
Router# show policy-map interface
Service-policy input: policy1
Class-map: class-default (match-any)
5 minute offered rate 0 bps, drop rate 0 bps
precedence cos table table-map1
Table 186 describes the fields shown in the display.
Table 186 show policy-map interface Field Descriptions—Configured for Enhanced Packet Marking1
Field
|
Description
|
Service-policy input
|
Name of the input service policy applied to the specified interface or VC.
|
Class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets, bytes
|
Number of the packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
offered rate
|
Rate, in kbps, of the packets coming into the class.
|
Match
|
Match criteria specified for the class of traffic. Choices include criteria such as Precedence, IP differentiated services code point (DSCP) value, Multiprotocol Label Switching (MPLS) experimental value, access groups, and quality of service (QoS) group (set). For more information about the variety of match criteria that are available, see the "Classifying Network Traffic" module in the Cisco IOS Quality of Service Solutions Configuration Guide.
|
QoS Set
|
Indicates that QoS group (set) has been configured for the particular class.
|
precedence cos table table-map1
|
Indicates that a table map (called "table-map1") has been used to determine the precedence value. The precedence value will be set according to the CoS value defined in the table map.
|
Packets marked
|
Total number of packets marked for the particular class.
|
Traffic Policing: Example
The following is sample output from the show policy-map interface command. This sample displays the statistics for the serial 2/0 interface on which traffic policing has been enabled. The committed (conform) burst (bc) and excess (peak) burst (be) are specified in milliseconds (ms).
Router# show policy-map interface serial2/0
Service-policy output: policy1 (1050)
Class-map: class1 (match-all) (1051/1)
5 minute offered rate 0 bps, drop rate 0 bps
Match: ip precedence 0 (1052)
cir 409500 bps, bc 15360 bytes
pir 819000 bps, be 40960 bytes
conformed 0 packets, 0 bytes; actions:
exceeded 0 packets, 0 bytes; actions:
violated 0 packets, 0 bytes; actions:
conformed 0 bps, exceed 0 bps, violate 0 bps
Class-map: class-default (match-any) (1054/0)
5 minute offered rate 0 bps, drop rate 0 bps
In this example, the CIR and PIR are displayed in bps, and both the committed burst (bc) and excess burst (be) are displayed in bits.
The CIR, PIR bc, and be are calculated on the basis of the formulas described below.
Formula for Calculating the CIR: Example
When calculating the CIR, the following formula is used:
•
CIR percentage specified (as shown in the output from the show policy-map command) * bandwidth (BW) of the interface (as shown in the output from the show interfaces command) = total bits per second
According to the output from the show interfaces command for the serial 2/0 interface, the interface has a bandwidth (BW) of 2048 kbps.
Router# show interfaces serial2/0
Serial2/0 is administratively down, line protocol is down
Hardware is M4T
MTU 1500 bytes, BW 2048 Kbit, DLY 20000 usec, rely 255/255, load 1/255
The following values are used for calculating the CIR:
20 % * 2048 kbps = 409600 bps
Formula for Calculating the PIR: Example
When calculating the PIR, the following formula is used:
•
PIR percentage specified (as shown in the output from the show policy-map command) * bandwidth (BW) of the interface (as shown in the output from the show interfaces command) = total bits per second
According to the output from the show interfaces command for the serial 2/0 interface, the interface has a bandwidth (BW) of 2048 kbps.
Router# show interfaces serial2/0
Serial2/0 is administratively down, line protocol is down
Hardware is M4T
MTU 1500 bytes, BW 2048 Kbit, DLY 20000 usec, rely 255/255, load 1/255
The following values are used for calculating the PIR:
40 % * 2048 kbps = 819200 bps
Note
Discrepancies between this total and the total shown in the output from the show policy-map interface command can be attributed to a rounding calculation or to differences associated with the specific interface configuration.
Formula for Calculating the Committed Burst (bc): Example
When calculating the bc, the following formula is used:
•
The bc in milliseconds (as shown in the show policy-map command) * the CIR in bits per seconds = total number bytes
The following values are used for calculating the bc:
300 ms * 409600 bps = 15360 bytes
Formula for Calculating the Excess Burst (be): Example
When calculating the bc and the be, the following formula is used:
•
The be in milliseconds (as shown in the show policy-map command) * the PIR in bits per seconds = total number bytes
The following values are used for calculating the be:
400 ms * 819200 bps = 40960 bytes
Table 187 describes the significant fields shown in the display.
Table 187 show policy-map interface Field Descriptions
Field
|
Description
|
Service-policy output
|
Name of the output service policy applied to the specified interface or VC.
|
Class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets and bytes
|
Number of packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
offered rate
|
Rate, in kbps, of packets coming in to the class.
|
drop rate
|
Rate, in kbps, at which packets are dropped from the class. The drop rate is calculated by subtracting the number of successfully transmitted packets from the offered rate.
|
Match
|
Match criteria specified for the class of traffic. Choices include criteria such as the Layer 3 packet length, IP precedence, IP differentiated services code point (DSCP) value, Multiprotocol Label Switching (MPLS) experimental value, access groups, and quality of service (QoS) groups. For more information about the variety of match criteria that are available, see the "Classifying Network Traffic" module in the Cisco IOS Quality of Service Solutions Configuration Guide.
|
police
|
Indicates that traffic policing has been enabled. Display includes the CIR, PIR (in both a percentage of bandwidth and in bps) and the bc and be in bytes and milliseconds. Also displays the optional conform, exceed, and violate actions, if any, and the statistics associated with these optional actions.
|
Bandwidth Estimation: Example
The following sample output from the show policy-map interface command displays statistics for the Fast Ethernet 0/1 interface on which bandwidth estimates for quality of service (QoS) targets have been generated.
The Bandwidth Estimation section indicates that bandwidth estimates for QoS targets have been defined. These targets include the packet loss rate, the packet delay rate, and the timeframe in milliseconds. Confidence refers to the drop-one-in value (as a percentage) of the targets. Corvil Bandwidth means the bandwidth estimate in kilobits per second.
When no drop or delay targets are specified, "none specified, falling back to drop no more than one packet in 500" appears in the output.
Router# show policy-map interface FastEthernet0/1
Service-policy output: my-policy
Class-map: icmp (match-all)
30 second offered rate 0 bps, drop rate 0 bps
Quality-of-Service targets:
drop no more than one packet in 1000 (Packet loss < 0.10%)
delay no more than one packet in 100 by 40 (or more) milliseconds
Corvil Bandwidth: 1 kbits/sec
Class-map: class-default (match-any)
30 second offered rate 0 bps, drop rate 0 bps
Quality-of-Service targets:
<none specified, falling back to drop no more than one packet in 500
Corvil Bandwidth: 1 kbits/sec
Shaping with HQF Enabled: Example
The following sample output from the show policy-map interface command shows that shaping is active (as seen in the queue depth field) with HQF enabled on the serial 4/3 interface. All traffic is classified to the class-default queue.
Note
In HQF images for Cisco IOS Releases 12.4(20)T and later, the packets delayed and bytes delayed counters were removed for traffic shaping classes.
Router# show policy-map interface serial4/3
Service-policy output: shape
Class-map: class-default (match-any)
2203 packets, 404709 bytes
30 second offered rate 74000 bps, drop rate 14000 bps
(queue depth/total drops/no-buffer drops) 64/354/0
(pkts output/bytes output) 1836/337280
shape (average) cir 128000, bc 1000, be 1000
lower bound cir 0, adapt to fecn 0
queue stats for all priority classes:
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 0/0
Class-map: c1 (match-all)
30 second offered rate 0 bps, drop rate 0 bps
Priority: 32 kbps, burst bytes 1500, b/w exceed drops: 0
Class-map: class-default (match-any)
2190 packets, 404540 bytes
30 second offered rate 74000 bps, drop rate 14000 bps
(queue depth/total drops/no-buffer drops) 63/417/0
(pkts output/bytes output) 2094/386300
Packets Matched on the Basis of VLAN ID Number: Example
Note
As of Cisco IOS Release 12.2(31)SB2, matching packets on the basis of VLAN ID numbers is supported on the Catalyst 1000 platform only.
The following is a sample configuration in which packets are matched and classified on the basis of the VLAN ID number. In this sample configuration, packets that match VLAN ID number 150 are placed in a class called "class1."
Class Map match-all class1 (id 3)
Class1 is then configured as part of the policy map called "policy1." The policy map is attached to Fast Ethernet subinterface 0/0.1.
The following sample output of the show policy-map interface command displays the packet statistics for the policy maps attached to Fast Ethernet subinterface 0/0.1. It displays the statistics for policy1, in which class1 has been configured.
Router# show policy-map interface
Service-policy input: policy1
! Class configured in the policy map.
Class-map: class1 (match-all)
5 minute offered rate 0 bps, drop rate 0 bps
! VLAN ID 150 is the match criterion for the class.
cir 8000000 bps, bc 512000000 bytes
conformed 0 packets, 0 bytes; actions:
exceeded 0 packets, 0 bytes; actions:
conformed 0 bps, exceed 0 bps
Class-map: class-default (match-any)
5 minute offered rate 0 bps, drop rate 0 bps
Table 188 describes the significant fields shown in the display.
Table 188 show policy-map interface Field Descriptions—Packets Matched on the Basis of VLAN ID Number1
Field
|
Description
|
Service-policy input
|
Name of the input service policy applied to the specified interface or VC.
|
Class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets, bytes
|
Number of the packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
offered rate
|
Rate, in kbps, of the packets coming into the class.
|
Match
|
Match criteria specified for the class of traffic. Choices include criteria such as VLAN ID number, precedence, IP differentiated services code point (DSCP) value, Multiprotocol Label Switching (MPLS) experimental value, access groups, and quality of service (QoS) group (set). For more information about the variety of match criteria that are available, see the "Classifying Network Traffic" module in the Cisco IOS Quality of Service Solutions Configuration Guide.
|
Cisco 7600 Series Routers: Example
The following example shows how to display the statistics and the configurations of all the input and output policies that are attached to an interface on a Cisco 7600 series router:
Router# show policy-map interface
service-policy input: max-pol-ipp5
class-map: ipp5 (match-all)
police 2000000000 2000000 conform-action set-prec-transmit 6 exceed-action p
The following example shows how to display the input-policy statistics and the configurations for a specific interface on a Cisco 7600 series router:
Router# show policy-map interface fastethernet 5/36 input
service-policy input: max-pol-ipp5
class-map: ipp5 (match-all)
police 2000000000 2000000 conform-action set-prec-transmit 6 exceed-action p
Table 189 describes the significant fields shown in the display.
Table 189 show policy-map interface Field Descriptions—Cisco 7600 Series Routers
Field
|
Description
|
service-policy input
|
Name of the input service policy applied to the specified interface.
|
class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets, bytes
|
Number of the packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
minute rate
|
Rate, in kbps, of the packets coming into the class.
|
match
|
Match criteria specified for the class of traffic. Choices include criteria such as VLAN ID number, precedence, IP differentiated services code point (DSCP) value, Multiprotocol Label Switching (MPLS) experimental value, access groups, and quality of service (QoS) group (set). For more information about the variety of match criteria that are available, see the "Classifying Network Traffic" module in the Cisco IOS Quality of Service Solutions Configuration Guide.
|
class
|
Precedence value.
|
police
|
Indicates that the police command has been configured to enable traffic policing.
|
Multiple Priority Queues on Serial Interface: Example
The following sample output from the show policy-map interface command shows the types of statistical information that displays when multiple priority queues are configured. Depending upon the interface in use and the options enabled, the output that you see may vary slightly from the output shown below.
Router# show policy-map interface
Service-policy output: P1
Queue statistics for all priority classes:
Class-map: Gold (match-all)
0 packets, 0 bytes /*Updated for each priority level configured.*/
5 minute offered rate 0 bps, drop rate 0 bps
Priority: 0 kbps, burst bytes 1500, b/w exceed drops: 0
Bandwidth-Remaining Ratios: Example
The following sample output from the show policy-map interface command indicates that bandwidth-remaining ratios are configured for class queues. As shown in the example, the classes precedence_0, precedence_1, and precedence_2 have bandwidth-remaining ratios of 20, 40, and 60, respectively.
Router# show policy-map interface GigabitEthernet1/0/0.10
Service-policy output: vlan10_policy
Class-map: class-default (match-any)
30 second offered rate 0 bps, drop rate 0 bps
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 0/0
shape (average) cir 1000000, bc 4000, be 4000
target shape rate 1000000
bandwidth remaining ratio 10
Service-policy : child_policy
Class-map: precedence_0 (match-all)
30 second offered rate 0 bps, drop rate 0 bps
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 0/0
shape (average) cir 500000, bc 2000, be 2000
bandwidth remaining ratio 20
Class-map: precedence_1 (match-all)
30 second offered rate 0 bps, drop rate 0 bps
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 0/0
shape (average) cir 500000, bc 2000, be 2000
bandwidth remaining ratio 40
Class-map: precedence_2 (match-all)
30 second offered rate 0 bps, drop rate 0 bps
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 0/0
shape (average) cir 500000, bc 2000, be 2000
bandwidth remaining ratio 60
Class-map: class-default (match-any)
30 second offered rate 0 bps, drop rate 0 bps
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 0/0
Table 190 describes the significant fields shown in the display.
Table 190 show policy-map interface Field Descriptions—Configured for Bandwidth-Remaining Ratios
Field
|
Description
|
Service-policy output
|
Name of the output service policy applied to the specified interface.
|
Class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets, bytes
|
Number of the packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
bandwidth remaining ratio
|
Indicates the ratio used to allocate excess bandwidth.
|
Tunnel Marking: Example
In this sample output of the show policy-map interface command, the character string "ip dscp tunnel 3" indicates that L2TPv3 tunnel marking has been configured to set the DSCP value to 3 in the header of a tunneled packet.
Router# show policy-map interface
Service-policy input: tunnel
Class-map: frde (match-all)
30 second offered rate 0 bps, drop rate 0 bps
Class-map: class-default (match-any)
13736 packets, 1714682 bytes
30 second offered rate 0 bps, drop rate 0 bps
13736 packets, 1714682 bytes
Table 191 describes the significant fields shown in the display.
Table 191 show policy-map interface Field Descriptions—Configured for Tunnel Marking
Field
|
Description
|
service-policy input
|
Name of the input service policy applied to the specified interface.
|
class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets, bytes
|
Number of the packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
offered rate
|
Rate, in kbps, of packets coming in to the class.
|
drop rate
|
Rate, in kbps, at which packets are dropped from the class. The drop rate is calculated by subtracting the number of successfully transmitted packets from the offered rate.
|
match
|
Match criteria specified for the class of traffic. In this example, the Frame Relay Discard Eligible (DE) bit has been specified as the match criterion.
For more information about the variety of match criteria that are available, see the "Classifying Network Traffic" module in the Cisco IOS Quality of Service Solutions Configuration Guide.
|
ip dscp tunnel
|
Indicates that tunnel marking has been configured to set the DSCP in the header of a tunneled packet to a value of 3.
|
Traffic Shaping Overhead Accounting for ATM: Example
The following output from the show policy-map interface command indicates that ATM overhead accounting is enabled for shaping and disabled for bandwidth:
Router# show policy-map interface
Service-policy output:unit-test
Class-map: class-default (match-any)
30 second offered rate 800 bps, drop rate 0 bps
shape (average) cir 154400, bc 7720, be 7720
overhead accounting: enabled
overhead accounting: disabled
(queue depth/total drops/no-buffer drops) 0/0/0
(packets output/bytes output) 100/1000
Table 192 describes the significant fields shown in the display.
Table 192 show policy-map interface Field Descriptions—Configured for Traffic Shaping Overhead Accounting for ATM
Field
|
Description
|
service-policy output
|
Name of the output service policy applied to the specified interface.
|
class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets, bytes
|
Number of the packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
offered rate
|
Rate, in kbps, of packets coming in to the class.
|
drop rate
|
Rate, in kbps, at which packets are dropped from the class. The drop rate is calculated by subtracting the number of successfully transmitted packets from the offered rate.
|
match
|
Match criteria specified for the class of traffic. In this example, the Frame Relay Discard Eligible (DE) bit has been specified as the match criterion.
For more information about the variety of match criteria that are available, see the "Classifying Network Traffic" module in the Cisco IOS Quality of Service Solutions Configuration Guide.
|
target shape rate
|
Indicates that traffic shaping is enabled at the specified rate.
|
overhead accounting
|
Indicates whether overhead accounting is enabled or disabled for traffic shaping.
|
bandwidth
|
Indicates the percentage of bandwidth allocated for traffic queueing.
|
overhead accounting:
|
Indicates whether overhead accounting is enabled or disabled for traffic queueing.
|
HQF: Example
The following output from the show policy-map interface command displays the configuration for Fast Ethernet interface 0/0.
Note
In HQF images for Cisco IOS Releases 12.4(20)T and later, the packets delayed and bytes delayed counters were removed for traffic shaping classes.
Router# show policy-map interface f0/0
Service-policy output: test1
Class-map: class-default (match-any)
30 second offered rate 0 bps, drop rate 0 bps
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 129/12562
shape (average) cir 1536000, bc 6144, be 6144
target shape rate 1536000
queue stats for all priority classes:
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 0/0
Class-map: RT (match-all)
30 second offered rate 0 bps, drop rate 0 bps
Priority: 20% (307 kbps), burst bytes 7650, b/w exceed drops: 0
Class-map: BH (match-all)
30 second offered rate 0 bps, drop rate 0 bps
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 0/0
Class-map: BL (match-all)
30 second offered rate 0 bps, drop rate 0 bps
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 0/0
Exp-weight-constant: 9 (1/512)
Mean queue depth: 0 packets
dscp Transmitted Random drop Tail drop Minimum Maximum Mark
pkts/bytes pkts/bytes pkts/bytes thresh thresh prob
af21 0/0 0/0 0/0 100 400 1/10
Class-map: class-default (match-any)
30 second offered rate 0 bps, drop rate 0 bps
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 129/12562
Table 193 describes the significant fields shown in the display.
Table 193 show policy-map interface Field Descriptions—Configured for HQF
Field
|
Description
|
FastEthernet
|
Name of the interface.
|
service-policy output
|
Name of the output service policy applied to the specified interface.
|
class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets, bytes
|
Number of the packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
offered rate
|
Rate, in kbps, of packets coming in to the class.
|
drop rate
|
Rate, in kbps, at which packets are dropped from the class. The drop rate is calculated by subtracting the number of successfully transmitted packets from the offered rate.
|
Match
|
Match criteria specified for the class of traffic.
Note For more information about the variety of match criteria that are available, see the "Classifying Network Traffic" module in the Cisco IOS Quality of Service Solutions Configuration Guide.
|
Queueing
|
Indicates that queueing is enabled.
|
queue limit
|
Maximum number of packets that a queue can hold for a class policy configured in a policy map.
|
bandwidth
|
Indicates the percentage of bandwidth allocated for traffic queueing.
|
dscp
|
Differentiated services code point (DSCP). Values can be the following:
• 0 to 63—Numerical DSCP values. The default value is 0.
• af1 to af43—Assured forwarding (AF) DSCP values.
• cs1 to cs7—Type of service (ToS) precedence values.
• default—Default DSCP value.
• ef—Expedited forwarding (EF) DSCP values.
|
Related Commands
Command
|
Description
|
bandwidth remaining ratio
|
Specifies a bandwidth-remaining ratio for class queues and subinterface-level queues to determine the amount of unused (excess) bandwidth to allocate to the queue during congestion.
|
class-map
|
Creates a class map to be used for matching packets to a specified class.
|
compression header ip
|
Configures RTP or TCP IP header compression for a specific class.
|
drop
|
Configures a traffic class to discard packets belonging to a specific class.
|
match fr-dlci
|
Specifies the Frame Relay DLCI number as a match criterion in a class map.
|
match packet length (class-map)
|
Specifies the length of the Layer 3 packet in the IP header as a match criterion in a class map.
|
police
|
Configures traffic policing.
|
police (percent)
|
Configures traffic policing on the basis of a percentage of bandwidth available on an interface.
|
police (two rates)
|
Configures traffic policing using two rates, the CIR and the PIR.
|
policy-map
|
Creates or modifies a policy map that can be attached to one or more interfaces to specify a service policy.
|
priority
|
Specifies that low-latency behavior must be given to a traffic class and configures multiple priority queues.
|
random-detect ecn
|
Enables ECN.
|
shape (percent)
|
Specifies average or peak rate traffic shaping on the basis of a percentage of bandwidth available on an interface.
|
show class-map
|
Display all class maps and their matching criteria.
|
show frame-relay pvc
|
Displays statistics about PVCs for Frame Relay interfaces.
|
show interfaces
|
Displays statistics for all interfaces configured on a router or access server.
|
show mls qos
|
Displays MLS QoS information.
|
show policy-map
|
Displays the configuration of all classes for a specified service policy map or all classes for all existing policy maps.
|
show policy-map class
|
Displays the configuration for the specified class of the specified policy map.
|
show table-map
|
Displays the configuration of a specified table map or of all table maps.
|
table-map (value mapping)
|
Creates and configures a mapping table for mapping and converting one packet-marking value to another.
|
show policy-map interface brief
To display information about only the active policy maps attached to an interface, use the show policy-map interface brief command in privileged EXEC mode.
show policy-map interface [input | output] brief [policy-map-name] [vrf [vrf-id]] [timestamp]
Syntax Description
input
|
(Optional) Indicates that only the information about the active input policy maps will be displayed.
|
output
|
(Optional) Indicates that only the information about the active output policy maps will be displayed.
|
brief
|
Indicates that the name of all the active policy maps (both input and output policy maps) and the interfaces to which the policy maps are attached will be displayed. The active input policy maps will be displayed first, followed by the output policy maps.
|
policy-map-name
|
(Optional) Name of an active policy map to be displayed.
|
vrf
|
(Optional) Indicates that the active policy maps for Virtual Private Network (VPN) routing and forwarding (VRF) instances will be displayed.
|
vrf-id
|
(Optional) A specific VRF identifier.
|
timestamp
|
(Optional) Indicates that the date and time when the policy map was attached will be displayed, along with the ID of the user who attached the policy map.
|
Command Default
If no optional keywords or arguments are specified, all policy maps (even those that are not active) are displayed.
Command Modes
Privileged EXEC (#)
Command History
Release
|
Modification
|
12.2(28)SB
|
This command was introduced.
|
12.2(33)SRB
|
This command was integrated into Cisco IOS Release 12.2(33)SRB.
|
12.2(33)SXH
|
This command was integrated into Cisco IOS Release 12.2(33)SXH.
|
12.4(20)T
|
This command was integrated into Cisco IOS Release 12.4(20)T.
|
Usage Guidelines
The show policy-map interface brief command displays the name of the active policy maps and the interfaces to which those policy maps are attached. An active policy map is one that is attached to an interface.
The optional keywords and arguments allow you to tailor the information displayed about VPNs, time stamps, and user IDs.
If you do not specify any optional keywords or arguments, all policy maps (even those that are not active) are displayed.
VPN Information Reported
The show policy-map interface brief command can be used for VRF interfaces in applications that use VPNs. To specify VRF interfaces, use the vrf keyword with the vrf-id argument.
Time-stamp and User ID Information Reported
If the optional timestamp keyword is used with the show policy-map interface brief command, the time and date when a policy map was attached to an interface appear in the display. In addition to the time and date information, the name (that is, the user ID) of the person who attached the policy map to the interface will be displayed.
Note
If the network software is reloaded (reinstalled), the time-stamp information (the time and date information) obtained will not be retained for any of the policy maps attached to interfaces on the network. Instead, the time and date information displayed will be the time and date when the software was reloaded.
Method for Obtaining User Information
The user information included in the display is obtained from the information that you enter when you log in to the router. For example, if you are using the SSH Secure Shell utility to log in to a router, you would typically enter your username and password. However, it is not always possible to obtain the user information. Instances where user information cannot be obtained include the following:
•
Not all routers require user information when you log in. Therefore, you may not be prompted to enter your username when you log in to a router.
•
If you are connecting to a console port using the Telnet utility in a DOS environment, you do not need to enter user information.
•
The user information cannot be retrieved because of system constraints or other factors.
If the user information cannot be obtained, the words "by unknown" will be displayed.
Hierarchical Policy Map Information
For a hierarchical policy map structure, only the information about the parent policy maps is displayed. Information about child policy maps is not displayed.
ATM PVCs
For ATM permanent virtual circuits (PVCs), policy maps do not remain associated with the interface if the ATM PVC is not working properly (that is, the ATM PVC is "down"). Therefore, if an ATM PVC is down, and a policy map is attached to an interface, the show policy-map interface brief command does not include information about the policy maps in the command output.
Examples
The information that is displayed by the show policy-map interface brief command varies according to the optional keywords and arguments that you specify.
The following sections list the significant keyword and argument combinations used with the command and describe the corresponding information displayed.
show policy-map interface brief Command Example
The show policy-map interface brief command displays all the attached policy maps (both input policy maps and output policy maps) along with the information about the interfaces to which the policy maps are attached. The input policy maps are displayed first, followed by the output policy maps.
Service-policy input: policyname1
Service-policy output: policyname1interface s2/0/1 interface s6/0/0
show policy-map interface brief timestamp Command Example
The show policy-map interface brief timestamp command displays all the attached policy maps (both input policy maps and output policy maps) along with the information about the interfaces to which the policy maps are attached. The input policy maps are displayed first, followed by the output policy maps.
The timestamp keyword displays the time and date when the policy map was attached to the specific interface, along with the user ID of the person who attached the policy map to the interface.
Service-policy input: parentpolicy1
Service-policy input: childpolicy1
interface s2/0/1 - applied 20:43:04 on 25/12/01 by user1
interface s6/0/1 - applied 19:43:04 on 25/12/01 by user1
Service-policy output: policyname2
interface s2/0/2 - applied 21:47:04 on 24/12/01 by user1
interface s6/0/1 - applied 19:43:04 on 25/12/01 by user1
show policy-map interface brief policy-map-name Command Example
The show policy-map interface brief policy-map-name command displays the policy map attached as either an input policy map or an output policy map, along with the information about the interface to which the policy map is attached. Only the policy map specified by the policy-map-name argument is displayed.
For example, the display for the show policy-map interface brief policyname1 command is as follows:
Service-policy input: policyname1
Service-policy output: policyname1
show policy-map interface brief policy-map-name timestamp Command Example
The show policy-map interface brief policy-map-name timestamp command displays the policy map attached as either an input policy map or an output policy map, along with the information about the interface to which it is attached. Only the policy map specified by the policy-map-name argument is displayed.
The timestamp keyword displays the time and date when the policy map was attached to the specific interface, along with the user ID of the person who attached the policy map to the interface.
For example, the display for the show policy-map interface brief policyname2 timestamp command is as follows:
Service-policy input: policyname2
interface s2/0/2 - applied 21:47:04 on 24/12/01 by user1
interface s6/0/1 - applied 19:43:04 on 25/12/01 by user1
Service-policy output: policyname2
interface s4/0/2 - applied 12:47:04 on 24/12/01 by user1
interface s7/0/1 - applied 14:43:04 on 25/12/01 by user1
show policy-map interface output brief Command Example
The show policy-map interface output brief command displays the attached output policy maps, along with the information about the interfaces to which they are attached.
Service-policy output: policyname1
show policy-map interface output brief timestamp Command Example
The show policy-map interface output brief timestamp command displays the attached output policy maps, along with the information about the interfaces to which they are attached.
The timestamp keyword displays the time and date when the policy map was attached to the specific interface, along with the user ID of the person who attached the policy map to the interface.
Service-policy output: policyname2
interface s2/0/2 - applied 21:47:04 on 24/12/01 by user1
interface s6/0/1 - applied 19:43:04 on 25/12/01 by user1
show policy-map interface input brief Command Example
The show policy-map interface input brief command displays the attached input policy maps, along with the information about the interfaces to which they are attached.
Service-policy input: policyname2
show policy-map interface input brief timestamp Command Example
The show policy-map interface input brief timestamp command displays the attached input policy maps, along with the information about the interfaces to which they are attached.
The timestamp keyword displays the time and date when the policy map was attached to the specific interface, along with the user ID of the person who attached the policy map to the interface.
Service-policy input: policyname2
interface s2/0/2 - applied 21:47:04 on 24/12/01 by user1
interface s6/0/1 - applied 19:43:04 on 25/12/01 by user1
show policy-map interface output brief policy-map-name Command Example
The show policy-map interface output brief policy-map-name command displays the attached output policy map, along with the information about the interface to which it is attached. Only the policy map specified by the policy-map-name argument is displayed.
For example, the display for the show policy-map interface output brief policyname1 command is as follows:
Service-policy output: policyname1
show policy-map interface output brief policy-map-name timestamp Command Example
The show policy-map interface output brief policy-map-name timestamp command displays the attached output policy map, along with the information about the interface to which it is attached. Only the policy map specified by the policy-map-name argument is displayed.
The timestamp keyword displays the time and date when the policy map was attached to the specific interface, along with the user ID of the person who attached the policy map to the interface.
For example, the display for the show policy-map interface output brief policyname2 timestamp command is as follows:
Service-policy output: policyname2
interface s2/0/2 - applied 21:47:04 on 24/12/01 by user1
interface s6/0/1 - applied 19:43:04 on 25/12/01 by user1
show policy-map interface input brief policy-map-name Command Example
The show policy-map interface input brief policy-map-name command displays the attached input policy map, along with the information about the interface to which it is attached. Only the policy map specified by the policy-map-name argument is displayed.
For example, the display for the show policy-map interface input brief policyname1 command is as follows:
Service-policy input: policyname1
show policy-map interface input brief policy-map-name timestamp Command Example
The show policy-map interface input brief policy-map-name timestamp command displays the attached input policy map, along with the information about the interface to which it is attached. Only the policy map specified by the policy-map-name argument is displayed.
The timestamp keyword displays the time and date when the policy map was attached to the specific interface, along with the user ID of the person who attached the policy map to the interface.
For example, the display for the show policy-map interface input brief policyname2 timestamp command is as follows:
Service-policy input: policyname2
interface s2/0/2 - applied 21:47:04 on 24/12/01 by user1
interface s6/0/1 - applied 19:43:04 on 25/12/01 by user1
show policy-map interface brief vrf Command Example
The show policy-map interface brief vrf command displays all the policy maps (both input policy maps and output policy maps), along with information about the interfaces and the VRFs to which the policy maps are attached.
Service-policy input: policyname1
Service-policy output: policyname2
show policy-map interface brief vrf timestamp Command Example
The show policy-map interface brief vrf timestamp command displays all the policy maps (both input policy maps and output policy maps), along with information about the interfaces and the VRFs to which the policy maps are attached.
The timestamp keyword displays the time and date when the policy map was attached to the specific interface, along with the user ID of the person who attached the policy map to the interface.
Service-policy input: policyname1
VRFA interface s2/0/1 - applied 21:47:04 on 23/12/01 by user1
VRFB interface s6/0/0 - applied 21:47:04 on 23/12/01 by user1
Service-policy output: policyname2
VRFC interface s2/0/3 - applied 20:47:04 on 23/12/01 by user1
VRFD interface s6/0/2 - applied 20:49:04 on 21/12/01 by user1
In some network configurations, the policy map may be attached to the interface initially, and then at a later time, the interface can be configured to act as a VRF interface. In this kind of network configuration, the time-stamp information displays the time when the policy map was attached to the interface. The display does not include the time when the interface was configured to act as a VRF interface. Displaying only the time when the policy map is attached to the interface also applies to the scenarios that are described in the following paragraph for other network configurations.
In other network configurations, a VRF may be attached to multiple interfaces as described in the following scenarios:
•
The policy map is also attached to both the interfaces and the VRFs. In this network configuration, all the interfaces should be shown in the display for the VRF, under the policy map name, as follows:
Service-policy input: policyname1
VRF1 interface s2/0/1 - applied 21:47:37 on 23/12/01 by user1
interface atm0/0 - applied 11:37:57 on 21/11/01 by user1
•
The policy map is not attached to all interfaces to which the specific VRF is attached. In this network configuration, only the VRF interfaces that have that policy map configured are displayed.
show policy-map interface brief policy-map-name vrf timestamp Command Example
The show policy-map interface brief policy-map-name vrf timestamp command displays the policy maps attached as either an input policy map or an output policy map, along with information about the interface and VRF to which the policy map is attached. Only the policy map specified by the policy-map-name argument is displayed.
The timestamp keyword displays the time and date when the policy map was attached to the specific interface, along with the user ID of the person who attached the policy map to the interface.
For example, the display for the show policy-map interface brief policyname1 vrf timestamp command is as follows:
Service-policy input: policyname1
VRF1 interface s2/0/1 - applied 21:47:04 on 23/12/01 by user1
Service-policy output: policyname1
VRF2 interface s6/0/1 - applied 21:47:04 on 23/12/01 by user1
show policy-map interface brief policy-map-name vrf vrf-id timestamp Command Example
The show policy-map interface brief policy-map-name vrf vrf-id timestamp command displays all the policy maps (both the input policy maps and the output policy maps), along with information about the interface and VRF to which the policy maps are attached. Only the policy map and VRF specified by the policy-map-name argument and the vrf-id argument are displayed.
The timestamp keyword displays the time and date when the policy map was attached to the specific interface, along with the user ID of the person who attached the policy map to the interface.
For example, the display for show policy-map interface brief policyname1 vrf VRFA timestamp command is as follows:
Service-policy input: policyname1
VRFA interface s2/0/1 - applied 21:47:04 on 23/12/01 by user1
Service-policy output: policyname1
VRFA interface s6/0/1 - applied 21:47:04 on 23/12/01 by user1
show policy-map interface output brief vrf Command Example
The show policy-map interface output brief vrf command displays the attached output policy maps, along with information about the interface and VRF to which the policy maps are attached.
Service-policy output: policyname2
show policy-map interface output brief vrf timestamp Command Example
The show policy-map interface output brief vrf timestamp command displays the attached output policy maps, along with information about the interface and VRF to which the policy maps are attached.
The timestamp keyword displays the time and date when the policy map was attached to the specific interface, along with the user ID of the person who attached the policy map to the interface.
Service-policy output: policyname2
VRFC interface s2/0/2 - applied 21:47:04 on 23/12/01 by user1
VRFA interface s6/0/1 - applied 21:47:04 on 23/12/01 by user1
show policy-map interface input brief vrf Command Example
The show policy-map interface input brief vrf command displays the attached input policy maps, along with information about the interface and VRF to which the policy maps are attached.
Service-policy input: policyname1
Service-policy input: policyname2
show policy-map interface input brief vrf timestamp Command Example
The show policy-map interface input brief vrf timestamp command displays the attached input policy maps, along with information about the interface and VRF to which the policy maps are attached.
The timestamp keyword displays the time and date when the policy map was attached to the specific interface, along with the user ID of the person who attached the policy map to the interface.
Service-policy input: policyname1
VRFA interface s2/0/1 - applied 21:47:04 on 23/12/01 by user1
VRFB interface s6/0/0 - applied 21:47:04 on 23/12/01 by user1
Service-policy input: policyname2
VRFC interface s2/0/3 - applied 20:47:04 on 23/12/01 by user1
VRFD interface s6/0/2 - applied 20:49:04 on 21/12/01 by user1
show policy-map interface input brief vrf vrf-id Command Example
The show policy-map interface input brief vrf vrf-id command displays the attached input policy maps, along with information about the interface and VRF to which the policy maps are attached. Only the policy maps attached to the VRF specified by the vrf-id argument are displayed.
For example, the display for the show policy-map interface input brief vrf VRFA command is as follows:
Service-policy input: policyname1
Service-policy input: policyname2
show policy-map interface output brief vrf vrf-id Command Example
The show policy-map interface output brief vrf vrf-id command displays the attached output policy maps, along with information about the interface and VRF to which the policy maps are attached. Only the policy maps attached to the VRF specified by the vrf-id argument are displayed.
For example, the display for the show policy-map interface output brief vrf VRFB command is as follows:
Service-policy output: policyname1
Service-policy output: policyname2
show policy-map interface input brief vrf vrf-id timestamp Command Example
The show policy-map interface input brief vrf vrf-id timestamp command displays the attached input policy maps, along with information about the interface and VRF to which the policy maps are attached. Only the policy maps attached to the VRF specified by the vrf-id argument are displayed.
The timestamp keyword displays the time and date when the policy map was attached to the specific interface, along with the user ID of the person who attached the policy map to the interface.
For example, the display for the show policy-map interface input brief vrf VRFA timestamp command is as follows:
Service-policy input: policyname1
VRFA interface s2/0/1 - applied 21:47:04 on 23/12/01 by user1
Service-policy input: policyname2
VRFA interface s6/0/1 - applied 21:47:04 on 23/12/01 by user1
show policy-map interface output brief vrf vrf-id timestamp Command Example
The show policy-map interface output brief vrf vrf-id timestamp command displays the attached output policy maps, along with information about the interface and VRF to which the policy maps are attached. Only the policy maps attached to the VRF specified by the vrf-id argument are displayed.
The timestamp keyword displays the time and date when the policy map was attached to the specific interface, along with the user ID of the person who attached the policy map to the interface.
For example, the display for the show policy-map interface output brief vrf VRFB timestamp command is as follows:
Service-policy output: policyname1
VRFB interface s2/0/1 - applied 21:47:04 on 23/12/01 by user1
Service-policy output: policyname2
VRFB interface s6/0/1 - applied 21:47:04 on 23/12/01 by user1
Table 194 describes the significant fields shown in the various displays.
Table 194 show policy-map interface brief Field Descriptions
Field
|
Description
|
Service-policy output: policyname2
|
Output policy map name.
|
Service-policy input: policyname2
|
Input policy map name.
|
interface s2/0/1
|
Interface to which the policy map is attached.
|
VRFA
|
VRF to which the policy map is attached.
|
applied 21:47:04 on 23/12/01
|
Time and date when the policy map was attached to the interface or VRF.
|
by user1
|
User ID of the person who attached the policy map to the interface or VRF.
|
Related Commands
Command
|
Description
|
show policy-map interface
|
Displays the packet statistics of all classes that are configured for all service policies either on the specified interface or subinterface or on a specific PVC on the interface.
|
show policy-map interface service instance
To display the policy-map information for a given service instance under a port channel, use the show policy-map interface service instance command in user EXEC or privileged EXEC mode.
show policy-map interface x service instance y
Syntax Description
x
|
The number of the interface or the port channel.
|
y
|
The number of the service instance.
|
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
12.2(33)SRC
|
This command was introduced on the Cisco 7600 series routers.
|
Examples
The following example shows the policy-map output for a hierarchical policy on a given service instance 1 under port channel 1:
Router# show policy-map interface port-channel 1 service instance 1
Service-policy output: hqos-pc-brr
Class-map: class-default (match-any)
5 minute offered rate 0 bps, drop rate 0 bps
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 0/0
shape (average) cir 20000000, bc 80000, be 80000
target shape rate 20000000
bandwidth remaining ratio 2
Service-policy : flat-pc-brr
Class-map: cos5 (match-all)
5 minute offered rate 0 bps, drop rate 0 bps
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 0/0
shape (average) cir 10000000, bc 40000, be 40000
target shape rate 10000000
Class-map: class-default (match-any)
5 minute offered rate 0 bps, drop rate 0 bps
(queue depth/total drops/no-buffer drops) 0/0/0
(pkts output/bytes output) 0/0
shape (average) cir 10000000, bc 40000, be 40000
target shape rate 10000000
Table 195 describes the significant fields shown in the display.
Table 195 show policy-map interface service instance Field Descriptions1
Field
|
Description
|
Fields Associated with Classes or Service Policies
|
Service-policy output
|
Name of the output service policy applied to the specified interface or VC.
|
Class-map
|
Class of traffic being displayed. Output is displayed for each configured class in the policy. The choice for implementing class matches (for example, match-all or match-any) can also appear next to the traffic class.
|
packets and bytes
|
Number of packets (also shown in bytes) identified as belonging to the class of traffic being displayed.
|
offered rate
|
Rate, in kbps, of packets coming in to the class.
Note If the packets are compressed over an outgoing interface, the improved packet rate achieved by packet compression is not reflected in the offered rate. Also, if the packets are classified before they enter a combination of tunnels (for example, a generic routing encapsulation (GRE) tunnel and an IP Security (IPSec) tunnel), the offered rate does not include all the extra overhead associated with tunnel encapsulation in general. Depending on the configuration, the offered rate may include no overhead, may include the overhead for only one tunnel encapsulation, or may include the overhead for all tunnel encapsulations. In most of the GRE and IPSec tunnel configurations, the offered rate includes the overhead for GRE tunnel encapsulation only.
|
drop rate
|
Rate, in kbps, at which packets are dropped from the class. The drop rate is calculated by subtracting the number of successfully transmitted packets from the offered rate.
|
Match
|
Match criteria specified for the class of traffic. Choices include criteria such as IP precedence, IP differentiated services code point (DSCP) value, Multiprotocol Label Switching (MPLS) experimental (EXP) value, access groups, and QoS groups. For more information about the variety of match criteria that are available, see the "Classifying Network Traffic" module in the Cisco IOS Quality of Service Solutions Configuration Guide.
|
Fields Associated with Queueing (if Enabled)
|
Output Queue
|
The weighted fair queueing (WFQ) conversation to which this class of traffic is allocated.
|
Bandwidth
|
Bandwidth, in either kbps or percentage, configured for this class and the burst size.
|
pkts matched/bytes matched
|
Number of packets (also shown in bytes) matching this class that were placed in the queue. This number reflects the total number of matching packets queued at any time. Packets matching this class are queued only when congestion exists. If packets match the class but are never queued because the network was not congested, those packets are not included in this total. However, if process switching is in use, the number of packets is always incremented even if the network is not congested.
|
depth/total drops/no-buffer drops
|
Number of packets discarded for this class. No-buffer indicates that no memory buffer exists to service the packet.
|
Fields Associated with Weighted Random Early Detection (WRED) (if Enabled)
|
exponential weight
|
Exponent used in the average queue size calculation for a WRED parameter group.
|
mean queue depth
|
Average queue depth based on the actual queue depth on the interface and the exponential weighting constant. It is a fluctuating average. The minimum and maximum thresholds are compared against this value to determine drop decisions.
|
class
|
IP precedence level.
|
Transmitted pkts/bytes
|
Number of packets (also shown in bytes) passed through WRED and not dropped by WRED.
Note  |