cc/td/doc/product/software/ios120/12supdoc/12cmdsum
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Quality of Service Commands

Quality of Service Commands

This chapter describes the function and displays the syntax for quality of service (QoS) commands. For more information about defaults and usage guidelines, see the corresponding chapter of the Quality of Service Solutions Command Reference.

access-list rate-limit

To configure an access list for use with committed access rate (CAR) policies, use the access-list rate-limit global configuration command. To remove the access list from the configuration, use the no form of this command.

access-list rate-limit acl-index {precedence | mac-address | mask prec-mask}
no access-list rate-limit acl-index {precedence | mac-address | mask prec-mask}

acl-index

Access list number. Use any number from 1 to 99 to classify packets by precedence or precedence mask, and use any number from 100 to 199 to classify by MAC address.

precedence

IP precedence.

mac-address

Address of the MAC.

mask prec-mask

IP precedence mask; a two-digit hexadecimal number. Use this option when you want to assign multiple precedences to the same rate-limit access list.


bgp-policy

To enable Policy Propagation via Border Gateway Protocol (BGP) on the interface, use the bgp-policy interface configuration command. To disable Policy Propagation via BGP, use the no form of this command.

bgp-policy ip-prec-map
no bgp-policy
ip-prec-map

ip-prec-map

QoS policy based on the IP precedence.


custom-queue-list

To assign a custom queue list to an interface, use the custom-queue-list interface configuration command. To remove a specific list or all list assignments, use the no form of the command.

custom-queue-list list
no custom-queue-list [list]

list

Any number from 1 to 16 for the custom queue list.


fair-queue

To enable weighted fair queueing (WFQ) for an interface, use the fair-queue interface configuration command. To disable weighted fair queueing for an interface, use the no form of this command.

fair-queue [congestive-discard-threshold [dynamic-queues [reservable-queues]]]
no fair-queue

congestive-discard-threshold

(Optional) Number of messages allowed in each queue. The default is 64 messages, and a new threshold must be a power of 2 in the range 16 to 4096. When a conversation reaches this threshold, new message packets are discarded.

dynamic-queues

(Optional) Number of dynamic queues used for best-effort conversations (that is, a normal conversation not requiring any special network services). Values are 16, 32, 64, 128, 256, 512, 1024, 2048, and 4096. The default is 256.

reservable-queues

(Optional) Number of reservable queues used for reserved conversations in the range 0 to 1000. The default is 0. Reservable queues are used for interfaces configured for features such as Resource Reservation Protocol (RSVP).


fair-queue (DWFQ)

To enable distributed weighted fair queueing (DWFQ), use the fair-queue interface configuration command. The command enables DWFQ on an interface using a VIP2-40 or greater interface processor. To disable DWFQ, use the no form of this command.

fair-queue
no fair-queue

ip rsvp bandwidth

To enable RSVP for IP on an interface, use the ip rsvp bandwidth interface configuration command. To disable RSVP, use the no form of the command.

ip rsvp bandwidth [interface-kbps [single-flow-kbps]]
no ip rsvp bandwidth [
interface-kbps [single-flow-kbps]]

interface-kbps

(Optional) Amount of bandwidth (in kbps) on interface to be reserved. The range is 1 to 10000000.

single-flow-kbps

(Optional) Amount of bandwidth (in kbps) allocated to a single flow. The range is 1 to 10000000.


ip rsvp neighbors

To enable neighbors to request a reservation, use the ip rsvp neighbors interface configuration command. To disable this feature, use the no form of the command.

ip rsvp neighbors access-list-number
no ip rsvp neighbors access-list-number

access-list-number

Number of a standard or extended access list. It can be any number from 1 to 199.


ip rsvp reservation

To enable a router to generate an RSVP RESV message, use the ip rsvp reservation interface configuration command. To disable this feature, use the no form of the command.

ip rsvp reservation session-ip-address sender-ip-address {tcp | udp | ip-protocol}
session-dport sender-sport next-hop-ip-address next-hop-interface {ff | se | wf}
{rate | load} [bandwidth [burst-size]]
no ip rsvp reservation session-ip-address sender-ip-address {tcp | udp | ip-protocol}
session-dport sender-sport next-hop-ip-address next-hop-interface {ff | se | wf}
{rate | load} [bandwidth [burst-size]]

session-ip-address

For unicast sessions, this is the address of the intended receiver; for multicast sessions, it is the IP multicast address of the session.

sender-ip-address

The IP address of the sender.

tcp | udp | ip-protocol

TCP, UDP, or IP protocol in the range 0 to 255.

session-dport
sender-sport

Session-dport is the destination port. Sender-sport is the source port. Port numbers are specified in all cases, as the use of 16-bit ports following the IP header is not limited to UDP or TCP. If destination is zero, source must be zero, and the implication is that ports are not checked. If destination is nonzero, source must be nonzero.

next-hop-ip-address

Host name or address of the receiver or the router closest to the receiver.

next-hop-interface

Next hop interface or subinterface type and number. Interface type can be ethernet, loopback, null, or serial.

ff | se | wf

Reservation style:

Fixed Filter (ff) is single reservation.

Shared Explicit (se) is shared reservation, limited scope.

Wild Card Filter (wf) is shared reservation, unlimited scope.

rate | load

QoS guaranteed bit rate service or controlled load service.

bandwidth

(Optional) Average bit rate (kbps) to reserve up to 75 percent of total on interface. The range is 1 to 10000000.

burst-size

(Optional) Maximum burst size (kilobytes of data in queue). The range is 1 to 65535.


ip rsvp sender

To enable a router to generate an RSVP PATH message, use the ip rsvp sender interface configuration command. To disable this feature, use the no form of the command.

ip rsvp sender session-ip-address sender-ip-address {tcp | udp | ip-protocol} session-dport
sender-sport previous-hop-ip-address previous-hop-interface
[bandwidth] [burst-size]
no ip rsvp sender session-ip-address sender-ip-address {tcp | udp | ip-protocol} session-dport
sender-sport previous-hop-ip-address previous-hop-interface
[bandwidth] [burst-size]

session-ip-address

For unicast sessions, this is the address of the intended receiver; for multicast sessions, it is the IP multicast address of the session.

sender-ip-address

The IP address of the sender.

tcp | udp | ip-protocol

TCP, UDP, or IP protocol in the range 0 to 255.

session-dport sender-sport

Session-dport is the destination port. Sender-sport is the source port. Port numbers are specified in all cases, as the use of 16-bit ports following the IP header is not limited to UDP or TCP. If destination is zero, source must be zero, and the implication is that ports are not checked. If destination is nonzero, source must be nonzero.

previous-hop-ip-address

Address of the sender or the router closest to the sender.

previous-hop-interface

Address of the previous hop interface or subinterface. Interface type can be ethernet, loopback, null, or serial.

bandwidth

(Optional) Average bit rate (kbps) to reserve up to 75 percent of total on interface. The range is 1 to 10000000.

burst-size

(Optional) Maximum burst size (kilobytes of data in queue). The range is 1 to 65535.


ip rsvp udp-multicast

To instruct the router to generate UDP-encapsulated RSVP multicasts whenever it generates an IP-encapsulated multicast packet, use the ip rsvp udp-multicast interface configuration command. To disable this feature, use the no form of the command.

ip rsvp udp-multicast [multicast-address]
no ip rsvp udp-multicast [multicast-address]

multicast-address

(Optional) Host name or UDP multicast address of router.


priority-group

To assign the specified priority list to an interface, use the priority-group interface configuration command. To remove the specified priority group assignment, use the no form of this command.

priority-group list-number
no priority-group

list-number

Priority list number assigned to the interface. Any number from 1 to 16.


priority-list default

To assign a priority queue for those packets that do not match any other rule in the priority list, use the priority-list default global configuration command. To return to the default or assign normal as the default, use the no form of this command.

priority-list list-number default {high | medium | normal | low}
no priority-list list-number default

list-number

Any number from 1 to 16 that identifies the priority list.

high | medium | normal | low

Priority queue level.


priority-list interface

To establish queueing priorities on packets entering from a given interface, use the priority-list interface global configuration command. To remove an entry from the list, use the no form of this command with the appropriate arguments.

priority-list list-number interface interface-type interface-number {high | medium |
normal | low}
no priority-list list-number interface

list-number

Arbitrary integer from 1 to 16 that identifies the priority list selected by the user.

interface-type

The name of the interface.

interface-number

The number of the interface.

high | medium | normal | low

Priority queue level.


priority-list protocol

To establish queueing priorities based upon the protocol type, use the priority-list protocol global configuration command. To remove a priority list entry assigned by protocol type, use the no form of the command followed by the appropriate list-number argument and the protocol keyword.

priority-list list-number protocol protocol-name {high | medium | normal | low}
queue-keyword keyword-value
no priority-list list-number protocol [protocol-name {high | medium | normal | low}
queue-keyword keyword-value]

list-number

Any number from 1 to 16 that identifies the priority list selected by the user.

protocol-name

Protocol type: aarp, apollo, appletalk, arp, bridge (transparent), clns, clns_es, clns_is, compressedtcp, cmns, decnet, decnet_node, decnet_router-l1, decnet_router-l2, dlsw, ip, ipx, pad, rsrb, stun, vines, xns, and x25.

high | medium | normal | low

Priority queue level.

queue-keyword keyword-value

Possible keywords are fragments, gt, list, lt, tcp, and udp.


priority-list queue-limit

To specify the maximum number of packets that can be waiting in each of the priority queues, use the priority-list queue-limit global configuration command. To select the normal queue, use the no form of this command.

priority-list list-number queue-limit [high-limit [medium-limit [normal-limit [low-limit]]]]
no priority-list list-number queue-limit

list-number

Any number from 1 to 16 that identifies the priority list.

high-limit
medium-limit
normal-limit
low-limit

(Optional) Priority queue maximum length. A value of 0 for any of the four arguments means that the queue can be of unlimited size for that particular queue.


queue-list default

To assign a priority queue for those packets that do not match any other rule in the queue list, use the queue-list default global configuration command. To restore the default value, use the no form of this command.

queue-list list-number default queue-number
no queue-list list-number default queue-number

list-number

Number of the queue list. Any number from 1 to 16.

queue-number

Number of the queue. Any number from 1 to 16.


queue-list interface

To establish queueing priorities on packets entering on an interface, use the queue-list interface global configuration command. To remove an entry from the list, use the no form of the command.

queue-list list-number interface interface-type interface-number queue-number
no queue-list list-number interface interface-type interface-number queue-number

list-number

Number of the queue list. Any number from 1 to 16.

interface-type

Name of the interface.

interface-number

Number of the interface.

queue-number

Number of the queue. Any number from 1 to 16.


queue-list protocol

To establish queueing priority based upon the protocol type, use the queue-list protocol global configuration command. To remove an entry from the list, use the no form of this command with the appropriate list number.

queue-list list-number protocol protocol-name queue-number queue-keyword keyword-value
no queue-list list-number protocol protocol-name queue-number queue-keyword keyword-value

list-number

Number of the queue list. Any number from 1 to 16.

protocol-name

Required argument that specifies the protocol type: aarp, apollo, appletalk, arp, bridge (transparent), clns, clns_es, clns_is, cmns, compressedtcp, decnet, decnet_node, decnet_routerl1, decnet_routerl2, dlsw, ip, ipx, pad, rsrb, stun, vines, xns, and x25.

queue-number

Number of the queue. Any number from 1 to 16.

queue-keyword keyword-value

Possible keywords are gt, list, lt, tcp, and udp.


queue-list queue byte-count

To specify how many bytes the system allows to be delivered from a given queue during a particular cycle, use the queue-list queue byte-count global configuration command. To return the byte count to the default value, use the no form of the command.

queue-list list-number queue queue-number byte-count byte-count-number
no queue-list list-number queue queue-number byte-count byte-count-number

list-number

Number of the queue list. Any number from 1 to 16.

queue-number

Number of the queue. Any number from 1 to 16.

byte-count-number

The lower boundary on how many bytes the system allows to be delivered from a given queue during a particular cycle.


queue-list queue limit

To designate the queue length limit for a queue, use the queue-list queue limit global configuration command. To return the queue length to the default value, use the no form of the command.

queue-list list-number queue queue-number limit limit-number
no queue-list list-number queue queue-number limit limit-number

list-number

Number of the queue list. Any number from 1 to 16.

queue-number

Number of the queue. Any number from 1 to 16.

limit-number

Maximum number of packets that can be enqueued at any time. The range is 0 to 32767 queue entries. A value of 0 means that the queue can be of unlimited size.


random-detect

To enable Weighted Random Early Detection (WRED) or Distributed WRED (DWRED), use the random-detect interface configuration command. To disable WRED and DWRED, use the no form of this command.

random-detect
no random-detect

random-detect exponential-weighting-constant

To configure the Weighted Random Early Detection (WRED) and Distributed WRED (DWRED) exponential weight factor for the average queue size calculation, use the random-detect exponential-weighting-constant interface configuration command. To return the value to the default, use the no form of this command.

random-detect exponential-weighting-constant exponent
no random-detect exponential-weighting-constant

exponent

Exponent from 1 to 16 used in the average queue size calculation.


random-detect precedence

To configure Weighted Random Early Detection (WRED) and Distributed WRED (DWRED) parameters for a particular IP precedence, use the random-detect precedence interface configuration command. To return the values to the default for the precedence, use the no form of this command.

random-detect precedence precedence min-threshold max-threshold mark-prob-denominator
no random-detect precedence precedence min-threshold max-threshold
mark-prob-denominator

precedence

IP precedence number. The value range is 0 to 7 and RSVP. For Cisco 7000 series routers with an RSP7000 interface processor and Cisco 7500 series routers with a VIP2-40 interface processor (VIP2-50 interface processor strongly recommended), the precedence value ranges from 0 to 7 only.

min-threshold

Minimum threshold in number of packets. The value range of this argument is 1 to 4096. When the average queue length reaches the minimum threshold, WRED drops all packets with the specified IP precedence.

max-threshold

Maximum threshold in number of packets. The value range of this argument is the value of the min-threshold argument to 4096. When the average queue length exceeds the maximum threshold, WRED drops all packets with the specified IP precedence.

mark-prob-denominator

Denominator for the fraction of packets dropped when the average queue depth is at the maximum threshold. For example, if the denominator is 512, one out of every 512 packets is dropped when the average queue is at the maximum threshold. The value range is 1 to 65536. The default is 10; one out of every ten packets is dropped at the maximum threshold.


rate-limit

To configure committed access rate (CAR) and Distributed CAR (DCAR) policies, use the rate-limit interface configuration command. To remove the rate limit from the configuration, use the no form of this command.

rate-limit {input | output} [access-group [rate-limit] acl-index] bps
burst-normal burst-max
conform-action action exceed-action action
no rate-limit {input | output} [access-group [rate-limit] acl-index] bps
burst-normal burst-max conform-action action exceed-action action

input

Applies this CAR traffic policy to packets received on this interface.

output

Applies this CAR traffic policy to packets sent on this interface.

access-group

(Optional) Applies this CAR traffic policy to the specified access list.

rate-limit

(Optional) The access list is a rate-limit access list.

acl-index

(Optional) Access list number.

bps

Average rate in bits per second. The value must be in increments of
8 kbps.

burst-normal

Normal burst size in bytes. The minimum value is bps divided by 2000.

burst-max

Excess burst size in bytes.

conform-action

Action to take on packets that conform to the rate limit.

action

Action to take on packets. Specify one of the following keywords:

· continue---Evaluate the next rate-limit command.

· drop---Drop the packet.

· set-prec-continue new-prec---Set the IP precedence and evaluate the next rate-limit command.

· set-prec-transmit new-prec---Set the IP precedence and transmit the packet.

· transmit---Transmit the packet.

exceed-action

Action to take on packets that exceed the rate limit.


set ip precedence

To set the precedence value in the IP header, use the set ip precedence route-map configuration command. To leave the precedence value alone, use the no form of this command.

set ip precedence [number | name]
no set ip precedence

number name

(Optional) A number and its associated name that set precedence bits in the IP header. The values from least to most important are as follows:

· 0 routine

· 1 priority

· 2 immediate

· 3 flash

· 4 flash-override

· 5 critical

· 6 internet

· 7 network

set ip qos-group

To set a group ID that can be used later to classify packets, use the set ip qos-group route-map configuration command. To remove the group ID, use the no form of this command.

set ip qos-group group-id
no set ip qos-group group-id

group-id

Group ID number in the range 0 to 99.


show access-lists

To display the contents of current IP and rate-limit access lists, use the show access-lists privileged EXEC command.

show access-lists [access-list-number]

access-list-number

(Optional) Access list number to display. The range is 1 to 199.


show access-lists rate-limit

To display information about rate-limit access lists, use the show access-lists rate-limit EXEC command.

show access-lists rate-limit [acl-index]

acl-index

(Optional) Rate-limit access list number from 1 to 199.


show interfaces

To display statistics for all interfaces, use the show interfaces EXEC command. The resulting output varies depending on the network for which an interface has been configured.

show interfaces [type slot / port-adapter / port]    (for ports on VIP interface processors in the
Cisco 7500 series routers)

type

(Optional) Type of interface.

slot

(Optional) Refer to the appropriate hardware manual for slot information.

port-adapter

(Optional) Refer to the appropriate hardware manual for information about port adapter compatibility.

port

(Optional) Refer to the appropriate hardware manual for port information.


show interfaces fair-queue

To display information and statistics about weighted fair queueing for a VIP-based interface, use the show interfaces fair-queue EXEC command.

show interfaces [interface-type interface-number] fair-queue

interface-type

(Optional) The name of the interface.

interface-number

(Optional) The number of the interface.


show interfaces random-detect

To display information about Weighted Random Early Detection (WRED) for a VIP-based interface, use the show interfaces random-detect EXEC command.

show interfaces [interface-type interface-number] random-detect

interface-type

(Optional) The name of the interface.

interface-number

(Optional) The number of the interface.


show interfaces rate-limit

To display information about committed access rate (CAR) for an interface, use the show interfaces rate-limit EXEC command.

show interfaces [interface-type interface-number] rate-limit

interface-type

(Optional) The name of the interface.

interface-number

(Optional) The number of the interface.


show ip cef

To display entries in the FIB table based on the IP address, use the show ip cef EXEC command.

show ip cef network [mask [longer-prefix]] [detail]

network

FIB entry for the specific destination network.

mask

(Optional) FIB entry for the specified destination network and mask.

longer-prefix

(Optional) FIB entries for all more specific destinations.

detail

(Optional) Detailed FIB information.


show ip interface

To display the usability status of interfaces configured for IP, use the show ip interface EXEC command.

show ip interface [interface-type interface-number]

interface-type

(Optional) The name of the interface.

interface-number

(Optional) The number of the interface.


show ip rsvp installed

To display RSVP-related installed filters and corresponding bandwidth information, use the show ip rsvp installed EXEC command.

show ip rsvp installed [interface-type interface-number]

interface-type

(Optional) The name of the interface.

interface-number

(Optional) The number of the interface.


show ip rsvp interface

To display RSVP-related interface information, use the show ip rsvp interface EXEC command.

show ip rsvp interface [interface-type interface-number]

interface-type

(Optional) The name of the interface.

interface-number

(Optional) The number of the interface.


show ip rsvp neighbor

To display current RSVP neighbors, use the show ip rsvp neighbor EXEC command.

show ip rsvp neighbor [interface-type interface-number]

interface-type

(Optional) The name of the interface.

interface-number

(Optional) The number of the interface.


show ip rsvp request

To display RSVP-related request information being requested upstream, use the show ip rsvp request EXEC command.

show ip rsvp request [interface-type interface-number]

interface-type

(Optional) The name of the interface.

interface-number

(Optional) The number of the interface.


show ip rsvp reservation

To display RSVP-related receiver information currently in the database, use the show ip rsvp reservation EXEC command.

show ip rsvp reservation [interface-type interface-number]

interface-type

(Optional) The name of the interface.

interface-number

(Optional) The number of the interface.


show ip rsvp sender

To display RSVP PATH-related sender information currently in the database, use the show ip rsvp sender EXEC command.

show ip rsvp sender [interface-type interface-number]

interface-type

The name of the interface.

interface-number

The number of the interface.


show queue

To list fair queueing configuration and statistics for a particular interface, use the show queue privileged EXEC command.

show queue interface-type interface-number

interface-type

The name of the interface.

interface-number

The number of the interface.


show queueing

To list all or selected configured queueing strategies, use the show queueing privileged EXEC command.

show queueing [custom | fair | priority | red]

custom

(Optional) Status of the custom queueing list configuration.

fair

(Optional) Status of the fair queueing configuration.

priority

(Optional) Status of the priority queueing list configuration.

red

(Optional) Status of the Weighted Random Early Detection (WRED) configuration.


show tech-support rsvp

To generate a report of all RSVP-related information, use the show tech-support rsvp command.

show tech-support rsvp

show traffic-shape

To display the current traffic-shaping configuration, use the show traffic-shape EXEC command.

show traffic-shape [interface-type]

interface-type

(Optional) The name of the interface.


show traffic-shape statistics

To display the current traffic-shaping statistics, use the show traffic-shape statistics EXEC command.

show traffic-shape statistics [interface-type]

interface-type

(Optional) The name of the interface.


traffic-shape adaptive

To configure a Frame Relay subinterface to estimate the available bandwidth when backward explicit congestion notifications (BECNs) are received, use the traffic-shape adaptive interface configuration command. To stop adapting to congestion signals, use the no form of this command.

traffic-shape adaptive [bit-rate]
no traffic-shape adaptive

bit-rate

(Optional) Lowest bit rate that traffic is shaped to in bits per second.


traffic-shape fecn-adapt

To reply to messages with the forward explicit congestion notification (FECN) bit, (which are set with TEST RESPONSE messages with the BECN bit set), use the traffic-shape fecn-adapt interface configuration command. To stop backward explicit congestion notification (BECN) message generation, use the no form of this command.

traffic-shape fecn-adapt
no
traffic-shape fecn-adapt

traffic-shape group

To enable traffic shaping based on a specific access list for outbound traffic on an interface, use the traffic-shape group interface configuration command. To disable traffic shaping on the interface for the access list, use the no form of this command.

traffic-shape group access-list bit-rate [burst-size [excess-burst-size]]
no traffic-shape group access-list

access-list

Number of the access list that controls the packets that traffic shaping is applied to on the interface.

bit-rate

Bit rate that traffic is shaped to in bits per second. This is the access bit rate that you contract with your service provider, or the service levels you intend to maintain.

burst-size

(Optional) Sustained number of bits that can be transmitted per interval. On Frame Relay interfaces, this is the committed burst size contracted with your service provider.

excess-burst-size

(Optional) Maximum number of bits that can exceed the burst size in the first interval in a congestion event. On Frame Relay interfaces, this is the excess burst size contracted with your service provider. The default is equal to the burst-size.


traffic-shape rate

To enable traffic shaping for outbound traffic on an interface, use the traffic-shape rate interface configuration command. To disable traffic shaping on the interface, use the no form of this command.

traffic-shape rate bit-rate [burst-size [excess-burst-size]]
no traffic-shape rate

bit-rate

Bit rate that traffic is shaped to in bits per second. This is the access bit rate that you contract with your service provider, or the service levels you intend to maintain.

burst-size

(Optional) Sustained number of bits that can be transmitted per interval. On Frame Relay interfaces, this is the committed burst size contracted with your service provider.

excess-burst-size

(Optional) Maximum number of bits that can exceed the burst size in the first interval in a congestion event. On Frame Relay interfaces, this is the excess burst size contracted with your service provider. The default is equal to the burst-size.



hometocprevnextglossaryfeedbacksearchhelp
Posted: Mon Feb 8 14:07:15 PST 1999
Copyright 1989-1999©Cisco Systems Inc.