2 * net/sched/sch_netem.c Network emulator
4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public License
6 * as published by the Free Software Foundation; either version
9 * Many of the algorithms and ideas for this came from
10 * NIST Net which is not copyrighted.
12 * Authors: Stephen Hemminger <shemminger@osdl.org>
13 * Catalin(ux aka Dino) BOIE <catab at umbrella dot ro>
16 #include <linux/module.h>
17 #include <linux/slab.h>
18 #include <linux/types.h>
19 #include <linux/kernel.h>
20 #include <linux/errno.h>
21 #include <linux/skbuff.h>
22 #include <linux/rtnetlink.h>
24 #include <net/netlink.h>
25 #include <net/pkt_sched.h>
29 /* Network Emulation Queuing algorithm.
30 ====================================
32 Sources: [1] Mark Carson, Darrin Santay, "NIST Net - A Linux-based
33 Network Emulation Tool
34 [2] Luigi Rizzo, DummyNet for FreeBSD
36 ----------------------------------------------------------------
38 This started out as a simple way to delay outgoing packets to
39 test TCP but has grown to include most of the functionality
40 of a full blown network emulator like NISTnet. It can delay
41 packets and add random jitter (and correlation). The random
42 distribution can be loaded from a table as well to provide
43 normal, Pareto, or experimental curves. Packet loss,
44 duplication, and reordering can also be emulated.
46 This qdisc does not do classification that can be handled in
47 layering other disciplines. It does not need to do bandwidth
48 control either since that can be handled by using token
49 bucket or other rate control.
52 struct netem_sched_data
{
54 struct qdisc_watchdog watchdog
;
56 psched_tdiff_t latency
;
57 psched_tdiff_t jitter
;
70 } delay_cor
, loss_cor
, dup_cor
, reorder_cor
, corrupt_cor
;
78 /* Time stamp put into socket buffer control block */
80 psched_time_t time_to_send
;
83 static inline struct netem_skb_cb
*netem_skb_cb(struct sk_buff
*skb
)
85 BUILD_BUG_ON(sizeof(skb
->cb
) <
86 sizeof(struct qdisc_skb_cb
) + sizeof(struct netem_skb_cb
));
87 return (struct netem_skb_cb
*)qdisc_skb_cb(skb
)->data
;
90 /* init_crandom - initialize correlated random number generator
91 * Use entropy source for initial seed.
93 static void init_crandom(struct crndstate
*state
, unsigned long rho
)
96 state
->last
= net_random();
99 /* get_crandom - correlated random number generator
100 * Next number depends on last value.
101 * rho is scaled to avoid floating point.
103 static u32
get_crandom(struct crndstate
*state
)
106 unsigned long answer
;
108 if (state
->rho
== 0) /* no correlation */
111 value
= net_random();
112 rho
= (u64
)state
->rho
+ 1;
113 answer
= (value
* ((1ull<<32) - rho
) + state
->last
* rho
) >> 32;
114 state
->last
= answer
;
118 /* tabledist - return a pseudo-randomly distributed value with mean mu and
119 * std deviation sigma. Uses table lookup to approximate the desired
120 * distribution, and a uniformly-distributed pseudo-random source.
122 static psched_tdiff_t
tabledist(psched_tdiff_t mu
, psched_tdiff_t sigma
,
123 struct crndstate
*state
,
124 const struct disttable
*dist
)
133 rnd
= get_crandom(state
);
135 /* default uniform distribution */
137 return (rnd
% (2*sigma
)) - sigma
+ mu
;
139 t
= dist
->table
[rnd
% dist
->size
];
140 x
= (sigma
% NETEM_DIST_SCALE
) * t
;
142 x
+= NETEM_DIST_SCALE
/2;
144 x
-= NETEM_DIST_SCALE
/2;
146 return x
/ NETEM_DIST_SCALE
+ (sigma
/ NETEM_DIST_SCALE
) * t
+ mu
;
150 * Insert one skb into qdisc.
151 * Note: parent depends on return value to account for queue length.
152 * NET_XMIT_DROP: queue length didn't change.
153 * NET_XMIT_SUCCESS: one skb was queued.
155 static int netem_enqueue(struct sk_buff
*skb
, struct Qdisc
*sch
)
157 struct netem_sched_data
*q
= qdisc_priv(sch
);
158 /* We don't fill cb now as skb_unshare() may invalidate it */
159 struct netem_skb_cb
*cb
;
160 struct sk_buff
*skb2
;
164 pr_debug("netem_enqueue skb=%p\n", skb
);
166 /* Random duplication */
167 if (q
->duplicate
&& q
->duplicate
>= get_crandom(&q
->dup_cor
))
170 /* Random packet drop 0 => none, ~0 => all */
171 if (q
->loss
&& q
->loss
>= get_crandom(&q
->loss_cor
))
177 return NET_XMIT_SUCCESS
| __NET_XMIT_BYPASS
;
183 * If we need to duplicate packet, then re-insert at top of the
184 * qdisc tree, since parent queuer expects that only one
185 * skb will be queued.
187 if (count
> 1 && (skb2
= skb_clone(skb
, GFP_ATOMIC
)) != NULL
) {
188 struct Qdisc
*rootq
= qdisc_root(sch
);
189 u32 dupsave
= q
->duplicate
; /* prevent duplicating a dup... */
192 qdisc_enqueue_root(skb2
, rootq
);
193 q
->duplicate
= dupsave
;
197 * Randomized packet corruption.
198 * Make copy if needed since we are modifying
199 * If packet is going to be hardware checksummed, then
200 * do it now in software before we mangle it.
202 if (q
->corrupt
&& q
->corrupt
>= get_crandom(&q
->corrupt_cor
)) {
203 if (!(skb
= skb_unshare(skb
, GFP_ATOMIC
)) ||
204 (skb
->ip_summed
== CHECKSUM_PARTIAL
&&
205 skb_checksum_help(skb
))) {
207 return NET_XMIT_DROP
;
210 skb
->data
[net_random() % skb_headlen(skb
)] ^= 1<<(net_random() % 8);
213 cb
= netem_skb_cb(skb
);
214 if (q
->gap
== 0 || /* not doing reordering */
215 q
->counter
< q
->gap
|| /* inside last reordering gap */
216 q
->reorder
< get_crandom(&q
->reorder_cor
)) {
218 psched_tdiff_t delay
;
220 delay
= tabledist(q
->latency
, q
->jitter
,
221 &q
->delay_cor
, q
->delay_dist
);
223 now
= psched_get_time();
224 cb
->time_to_send
= now
+ delay
;
226 ret
= qdisc_enqueue(skb
, q
->qdisc
);
229 * Do re-ordering by putting one out of N packets at the front
232 cb
->time_to_send
= psched_get_time();
235 __skb_queue_head(&q
->qdisc
->q
, skb
);
236 q
->qdisc
->qstats
.backlog
+= qdisc_pkt_len(skb
);
237 q
->qdisc
->qstats
.requeues
++;
238 ret
= NET_XMIT_SUCCESS
;
241 if (likely(ret
== NET_XMIT_SUCCESS
)) {
243 sch
->bstats
.bytes
+= qdisc_pkt_len(skb
);
244 sch
->bstats
.packets
++;
245 } else if (net_xmit_drop_count(ret
)) {
249 pr_debug("netem: enqueue ret %d\n", ret
);
253 static unsigned int netem_drop(struct Qdisc
* sch
)
255 struct netem_sched_data
*q
= qdisc_priv(sch
);
256 unsigned int len
= 0;
258 if (q
->qdisc
->ops
->drop
&& (len
= q
->qdisc
->ops
->drop(q
->qdisc
)) != 0) {
265 static struct sk_buff
*netem_dequeue(struct Qdisc
*sch
)
267 struct netem_sched_data
*q
= qdisc_priv(sch
);
270 if (sch
->flags
& TCQ_F_THROTTLED
)
273 skb
= q
->qdisc
->ops
->peek(q
->qdisc
);
275 const struct netem_skb_cb
*cb
= netem_skb_cb(skb
);
276 psched_time_t now
= psched_get_time();
278 /* if more time remaining? */
279 if (cb
->time_to_send
<= now
) {
280 skb
= qdisc_dequeue_peeked(q
->qdisc
);
284 #ifdef CONFIG_NET_CLS_ACT
286 * If it's at ingress let's pretend the delay is
287 * from the network (tstamp will be updated).
289 if (G_TC_FROM(skb
->tc_verd
) & AT_INGRESS
)
290 skb
->tstamp
.tv64
= 0;
292 pr_debug("netem_dequeue: return skb=%p\n", skb
);
297 qdisc_watchdog_schedule(&q
->watchdog
, cb
->time_to_send
);
303 static void netem_reset(struct Qdisc
*sch
)
305 struct netem_sched_data
*q
= qdisc_priv(sch
);
307 qdisc_reset(q
->qdisc
);
309 qdisc_watchdog_cancel(&q
->watchdog
);
313 * Distribution data is a variable size payload containing
314 * signed 16 bit values.
316 static int get_dist_table(struct Qdisc
*sch
, const struct nlattr
*attr
)
318 struct netem_sched_data
*q
= qdisc_priv(sch
);
319 unsigned long n
= nla_len(attr
)/sizeof(__s16
);
320 const __s16
*data
= nla_data(attr
);
321 spinlock_t
*root_lock
;
328 d
= kmalloc(sizeof(*d
) + n
*sizeof(d
->table
[0]), GFP_KERNEL
);
333 for (i
= 0; i
< n
; i
++)
334 d
->table
[i
] = data
[i
];
336 root_lock
= qdisc_root_sleeping_lock(sch
);
338 spin_lock_bh(root_lock
);
339 kfree(q
->delay_dist
);
341 spin_unlock_bh(root_lock
);
345 static void get_correlation(struct Qdisc
*sch
, const struct nlattr
*attr
)
347 struct netem_sched_data
*q
= qdisc_priv(sch
);
348 const struct tc_netem_corr
*c
= nla_data(attr
);
350 init_crandom(&q
->delay_cor
, c
->delay_corr
);
351 init_crandom(&q
->loss_cor
, c
->loss_corr
);
352 init_crandom(&q
->dup_cor
, c
->dup_corr
);
355 static void get_reorder(struct Qdisc
*sch
, const struct nlattr
*attr
)
357 struct netem_sched_data
*q
= qdisc_priv(sch
);
358 const struct tc_netem_reorder
*r
= nla_data(attr
);
360 q
->reorder
= r
->probability
;
361 init_crandom(&q
->reorder_cor
, r
->correlation
);
364 static void get_corrupt(struct Qdisc
*sch
, const struct nlattr
*attr
)
366 struct netem_sched_data
*q
= qdisc_priv(sch
);
367 const struct tc_netem_corrupt
*r
= nla_data(attr
);
369 q
->corrupt
= r
->probability
;
370 init_crandom(&q
->corrupt_cor
, r
->correlation
);
373 static const struct nla_policy netem_policy
[TCA_NETEM_MAX
+ 1] = {
374 [TCA_NETEM_CORR
] = { .len
= sizeof(struct tc_netem_corr
) },
375 [TCA_NETEM_REORDER
] = { .len
= sizeof(struct tc_netem_reorder
) },
376 [TCA_NETEM_CORRUPT
] = { .len
= sizeof(struct tc_netem_corrupt
) },
379 static int parse_attr(struct nlattr
*tb
[], int maxtype
, struct nlattr
*nla
,
380 const struct nla_policy
*policy
, int len
)
382 int nested_len
= nla_len(nla
) - NLA_ALIGN(len
);
386 if (nested_len
>= nla_attr_size(0))
387 return nla_parse(tb
, maxtype
, nla_data(nla
) + NLA_ALIGN(len
),
389 memset(tb
, 0, sizeof(struct nlattr
*) * (maxtype
+ 1));
393 /* Parse netlink message to set options */
394 static int netem_change(struct Qdisc
*sch
, struct nlattr
*opt
)
396 struct netem_sched_data
*q
= qdisc_priv(sch
);
397 struct nlattr
*tb
[TCA_NETEM_MAX
+ 1];
398 struct tc_netem_qopt
*qopt
;
404 qopt
= nla_data(opt
);
405 ret
= parse_attr(tb
, TCA_NETEM_MAX
, opt
, netem_policy
, sizeof(*qopt
));
409 ret
= fifo_set_limit(q
->qdisc
, qopt
->limit
);
411 pr_debug("netem: can't set fifo limit\n");
415 q
->latency
= qopt
->latency
;
416 q
->jitter
= qopt
->jitter
;
417 q
->limit
= qopt
->limit
;
420 q
->loss
= qopt
->loss
;
421 q
->duplicate
= qopt
->duplicate
;
423 /* for compatibility with earlier versions.
424 * if gap is set, need to assume 100% probability
429 if (tb
[TCA_NETEM_CORR
])
430 get_correlation(sch
, tb
[TCA_NETEM_CORR
]);
432 if (tb
[TCA_NETEM_DELAY_DIST
]) {
433 ret
= get_dist_table(sch
, tb
[TCA_NETEM_DELAY_DIST
]);
438 if (tb
[TCA_NETEM_REORDER
])
439 get_reorder(sch
, tb
[TCA_NETEM_REORDER
]);
441 if (tb
[TCA_NETEM_CORRUPT
])
442 get_corrupt(sch
, tb
[TCA_NETEM_CORRUPT
]);
448 * Special case version of FIFO queue for use by netem.
449 * It queues in order based on timestamps in skb's
451 struct fifo_sched_data
{
453 psched_time_t oldest
;
456 static int tfifo_enqueue(struct sk_buff
*nskb
, struct Qdisc
*sch
)
458 struct fifo_sched_data
*q
= qdisc_priv(sch
);
459 struct sk_buff_head
*list
= &sch
->q
;
460 psched_time_t tnext
= netem_skb_cb(nskb
)->time_to_send
;
463 if (likely(skb_queue_len(list
) < q
->limit
)) {
464 /* Optimize for add at tail */
465 if (likely(skb_queue_empty(list
) || tnext
>= q
->oldest
)) {
467 return qdisc_enqueue_tail(nskb
, sch
);
470 skb_queue_reverse_walk(list
, skb
) {
471 const struct netem_skb_cb
*cb
= netem_skb_cb(skb
);
473 if (tnext
>= cb
->time_to_send
)
477 __skb_queue_after(list
, skb
, nskb
);
479 sch
->qstats
.backlog
+= qdisc_pkt_len(nskb
);
480 sch
->bstats
.bytes
+= qdisc_pkt_len(nskb
);
481 sch
->bstats
.packets
++;
483 return NET_XMIT_SUCCESS
;
486 return qdisc_reshape_fail(nskb
, sch
);
489 static int tfifo_init(struct Qdisc
*sch
, struct nlattr
*opt
)
491 struct fifo_sched_data
*q
= qdisc_priv(sch
);
494 struct tc_fifo_qopt
*ctl
= nla_data(opt
);
495 if (nla_len(opt
) < sizeof(*ctl
))
498 q
->limit
= ctl
->limit
;
500 q
->limit
= max_t(u32
, qdisc_dev(sch
)->tx_queue_len
, 1);
502 q
->oldest
= PSCHED_PASTPERFECT
;
506 static int tfifo_dump(struct Qdisc
*sch
, struct sk_buff
*skb
)
508 struct fifo_sched_data
*q
= qdisc_priv(sch
);
509 struct tc_fifo_qopt opt
= { .limit
= q
->limit
};
511 NLA_PUT(skb
, TCA_OPTIONS
, sizeof(opt
), &opt
);
518 static struct Qdisc_ops tfifo_qdisc_ops __read_mostly
= {
520 .priv_size
= sizeof(struct fifo_sched_data
),
521 .enqueue
= tfifo_enqueue
,
522 .dequeue
= qdisc_dequeue_head
,
523 .peek
= qdisc_peek_head
,
524 .drop
= qdisc_queue_drop
,
526 .reset
= qdisc_reset_queue
,
527 .change
= tfifo_init
,
531 static int netem_init(struct Qdisc
*sch
, struct nlattr
*opt
)
533 struct netem_sched_data
*q
= qdisc_priv(sch
);
539 qdisc_watchdog_init(&q
->watchdog
, sch
);
541 q
->qdisc
= qdisc_create_dflt(qdisc_dev(sch
), sch
->dev_queue
,
543 TC_H_MAKE(sch
->handle
, 1));
545 pr_debug("netem: qdisc create failed\n");
549 ret
= netem_change(sch
, opt
);
551 pr_debug("netem: change failed\n");
552 qdisc_destroy(q
->qdisc
);
557 static void netem_destroy(struct Qdisc
*sch
)
559 struct netem_sched_data
*q
= qdisc_priv(sch
);
561 qdisc_watchdog_cancel(&q
->watchdog
);
562 qdisc_destroy(q
->qdisc
);
563 kfree(q
->delay_dist
);
566 static int netem_dump(struct Qdisc
*sch
, struct sk_buff
*skb
)
568 const struct netem_sched_data
*q
= qdisc_priv(sch
);
569 unsigned char *b
= skb_tail_pointer(skb
);
570 struct nlattr
*nla
= (struct nlattr
*) b
;
571 struct tc_netem_qopt qopt
;
572 struct tc_netem_corr cor
;
573 struct tc_netem_reorder reorder
;
574 struct tc_netem_corrupt corrupt
;
576 qopt
.latency
= q
->latency
;
577 qopt
.jitter
= q
->jitter
;
578 qopt
.limit
= q
->limit
;
581 qopt
.duplicate
= q
->duplicate
;
582 NLA_PUT(skb
, TCA_OPTIONS
, sizeof(qopt
), &qopt
);
584 cor
.delay_corr
= q
->delay_cor
.rho
;
585 cor
.loss_corr
= q
->loss_cor
.rho
;
586 cor
.dup_corr
= q
->dup_cor
.rho
;
587 NLA_PUT(skb
, TCA_NETEM_CORR
, sizeof(cor
), &cor
);
589 reorder
.probability
= q
->reorder
;
590 reorder
.correlation
= q
->reorder_cor
.rho
;
591 NLA_PUT(skb
, TCA_NETEM_REORDER
, sizeof(reorder
), &reorder
);
593 corrupt
.probability
= q
->corrupt
;
594 corrupt
.correlation
= q
->corrupt_cor
.rho
;
595 NLA_PUT(skb
, TCA_NETEM_CORRUPT
, sizeof(corrupt
), &corrupt
);
597 nla
->nla_len
= skb_tail_pointer(skb
) - b
;
606 static struct Qdisc_ops netem_qdisc_ops __read_mostly
= {
608 .priv_size
= sizeof(struct netem_sched_data
),
609 .enqueue
= netem_enqueue
,
610 .dequeue
= netem_dequeue
,
611 .peek
= qdisc_peek_dequeued
,
614 .reset
= netem_reset
,
615 .destroy
= netem_destroy
,
616 .change
= netem_change
,
618 .owner
= THIS_MODULE
,
622 static int __init
netem_module_init(void)
624 pr_info("netem: version " VERSION
"\n");
625 return register_qdisc(&netem_qdisc_ops
);
627 static void __exit
netem_module_exit(void)
629 unregister_qdisc(&netem_qdisc_ops
);
631 module_init(netem_module_init
)
632 module_exit(netem_module_exit
)
633 MODULE_LICENSE("GPL");