Service Egress and Ingress QoS Policies
Quality of Service Guide 259
adaptation-rule
Syntax adaptation-rule [pir {max | min | closest}] [cir {max | min | closest}]
no adaptation-rule
Context config>qos>sap-ingress>policer
Description This command is used to define how the policer’s configuration parameters are translated into the
underlying hardware capabilities used to implement each policer instance. For instance, the configured
rates for the policer need to be mapped to the timers and decrement granularity used by the hardware's
leaky bucket functions that actually perform the traffic metering. If a rate is defined that cannot be
exactly matched by the hardware, the adaptation-rule setting provides guidance for which hardware
rate should be used.
The max keyword tells the system that the defined rate is the maximum rate that should be given to
the policer. If the hardware cannot exactly match the given rate, the next lowest hardware supported
rate is used.
The min keyword tells the system that the defined rate is the minimum rate that should be given to the
policer. If the hardware cannot exactly match the given rate, the next highest hardware supported rate
is used.
The closest keyword tells the system that the defined rate is the target rate for the policer. If the
hardware cannot exactly match the given rate, the system will use the closest hardware supported rate
compared to the target rate.
The hardware also needs to adapt the given mbs and cbs values into the PIR bucket violate threshold
(discard) and the CIR bucket exceed threshold (out-of-profile). The hardware may not have an exact
threshold match which it can use. In R8.0, the system treats the mbs and cbs values as minimum
threshold values.
The no form of this command is used to return the policer’s metering and profiling hardware
adaptation rules to closest.
Parameters pir {max | min | closest} — When the optional pir parameter is specified, the max, min or
closest keyword qualifier must follow.
max — The max keyword is used to inform the system that the metering rate defined for the
policer is the maximum allowed rate. The system will choose a hardware supported rate that
is closest but not exceeding the specified rate.
min — The min keyword is used to inform the system that the metering rate defined for the
policer is the minimum allowed rate. The system will choose a hardware supported rate that
is closest but not lower than the specified rate.
closest — The closest keyword is used to inform the system that the metering rate defined for the
policer is the target rate. The system will choose a hardware supported rate that is closest to
the specified rate.
Default closest
cir {max | min | closest} — When the optional cir parameter is specified, the max, min or closest
keyword qualifier must follow.