tc-drr(8)

NAME

   drr - deficit round robin scheduler

SYNOPSIS

   tc qdisc ... add drr [ quantum bytes ]

DESCRIPTION

   The Deficit Round Robin Scheduler is a classful queuing discipline as a
   more flexible replacement for Stochastic Fairness Queuing.

   Unlike SFQ, there are no built-in queues -- you need to add classes and
   then  set  up  filters  to  classify  packets accordingly.  This can be
   useful e.g. for using RED qdiscs with different settings for particular
   traffic. There is no default class -- if a packet cannot be classified,
   it is dropped.

ALGORITHM

   Each class is assigned a deficit counter, initialized to quantum.

   DRR maintains an (internal) ''active'' list of classes whose qdiscs are
   non-empty.  This  list is used for dequeuing. A packet is dequeued from
   the class at the head of the list if the  packet  size  is  smaller  or
   equal  to  the  deficit  counter.  If  the  counter is too small, it is
   increased by quantum and the scheduler moves on to the  next  class  in
   the active list.

PARAMETERS

   quantum
          Amount  of  bytes  a  flow  is  allowed  to  dequeue  before the
          scheduler moves to the next class. Defaults to the  MTU  of  the
          interface. The minimum value is 1.

EXAMPLE & USAGE

   To attach to device eth0, using the interface MTU as its quantum:

   # tc qdisc add dev eth0 handle 1 root drr

   Adding two classes:

   # tc class add dev eth0 parent 1: classid 1:1 drr
   # tc class add dev eth0 parent 1: classid 1:2 drr

   You also need to add at least one filter to classify packets.

   # tc filter add dev eth0 protocol .. classid 1:1

   Like  SFQ,  DRR  is  only useful when it owns the queue -- it is a pure
   scheduler and does not  delay  packets.  Attaching  non-work-conserving
   qdiscs like tbf to it does not make sense -- other qdiscs in the active
   list will also become inactive until the  dequeue  operation  succeeds.
   Embed  DRR  within another qdisc like HTB or HFSC to ensure it owns the
   queue.

   You can mimic SFQ behavior by assigning packets to the attached classes
   using the flow filter:

   tc qdisc add dev .. drr

   for i in .. 1024;do
        tc class add dev .. classid $handle:$(print %x $i)
        tc qdisc add dev .. fifo limit 16
   done

   tc   filter   add   ..   protocol   ip   ..   $handle  flow  hash  keys
   src,dst,proto,proto-src,proto-dst divisor 1024 perturb 10

SOURCE

   o      M. Shreedhar and George Varghese "Efficient Fair  Queuing  using
          Deficit Round Robin", Proc. SIGCOMM 95.

NOTES

   This  implementation  does  not  drop packets from the longest queue on
   overrun, as limits are handled by the individual child qdiscs.

SEE ALSO

   tc(8), tc-htb(8), tc-sfq(8)

AUTHOR

   sched_drr was written by Patrick McHardy.

---

Free and Open Source Software