Blame man/man8/tc-choke.8

Packit d3f73b
.TH TC 8 "August 2011" "iproute2" "Linux"
Packit d3f73b
.SH NAME
Packit d3f73b
choke \- choose and keep scheduler
Packit d3f73b
.SH SYNOPSIS
Packit d3f73b
.B tc qdisc ... choke
Packit d3f73b
.B limit
Packit d3f73b
packets
Packit d3f73b
.B min
Packit d3f73b
packets
Packit d3f73b
.B max
Packit d3f73b
packets
Packit d3f73b
.B avpkt
Packit d3f73b
bytes
Packit d3f73b
.B burst
Packit d3f73b
packets
Packit d3f73b
.B [ ecn ] [ bandwidth
Packit d3f73b
rate
Packit d3f73b
.B ] probability
Packit d3f73b
chance
Packit d3f73b
Packit d3f73b
.SH DESCRIPTION
Packit d3f73b
Packit d3f73b
CHOKe (CHOose and Keep for responsive flows, CHOose and Kill for unresponsive flows)
Packit d3f73b
is a classless qdisc designed to both identify and penalize flows that monopolize the
Packit d3f73b
queue. CHOKe is a variation of RED, and the configuration is similar to RED.
Packit d3f73b
Packit d3f73b
.SH ALGORITHM
Packit d3f73b
Once the queue hits a certain average length, a random packet is drawn from the
Packit d3f73b
queue. If both the to-be-queued and the drawn packet belong to the same flow,
Packit d3f73b
both packets are dropped. Otherwise, if the queue length is still below the maximum length,
Packit d3f73b
the new packet has a configurable chance of being marked (which may mean dropped).
Packit d3f73b
If the queue length exceeds
Packit d3f73b
.BR max ,
Packit d3f73b
the new packet will always be marked (or dropped).
Packit d3f73b
If the queue length exceeds
Packit d3f73b
.BR limit ,
Packit d3f73b
the new packet is always dropped.
Packit d3f73b
Packit d3f73b
The marking probability computation is the same as used by the RED qdisc.
Packit d3f73b
Packit d3f73b
.SH PARAMETERS
Packit d3f73b
The parameters are the same as for RED, except that RED uses bytes whereas choke
Packit d3f73b
counts packets. See
Packit d3f73b
.BR tc-red (8)
Packit d3f73b
for a description.
Packit d3f73b
Packit d3f73b
.SH SOURCE
Packit d3f73b
.TP
Packit d3f73b
o
Packit d3f73b
R. Pan, B. Prabhakar, and K. Psounis, "CHOKe, A Stateless
Packit d3f73b
Active Queue Management Scheme for Approximating Fair Bandwidth Allocation",
Packit d3f73b
IEEE INFOCOM, 2000.
Packit d3f73b
.TP
Packit d3f73b
o
Packit d3f73b
A. Tang, J. Wang, S. Low, "Understanding CHOKe: Throughput and Spatial
Packit d3f73b
Characteristics", IEEE/ACM Transactions on Networking, 2004
Packit d3f73b
Packit d3f73b
.SH SEE ALSO
Packit d3f73b
.BR tc (8),
Packit d3f73b
.BR tc-red (8)
Packit d3f73b
Packit d3f73b
.SH AUTHOR
Packit d3f73b
sched_choke was contributed by Stephen Hemminger.