syscons,vt: improve phrasing in kern.vty man page description
[freebsd-src.git] / sys / netgraph / ng_pipe.c
blobceb3a4efeaf6a957729b0f26829f632112254dd1
1 /*-
2 * Copyright (c) 2004-2010 University of Zagreb
3 * Copyright (c) 2007-2008 FreeBSD Foundation
5 * This software was developed by the University of Zagreb and the
6 * FreeBSD Foundation under sponsorship by the Stichting NLnet and the
7 * FreeBSD Foundation.
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
11 * are met:
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in the
16 * documentation and/or other materials provided with the distribution.
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
19 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 * SUCH DAMAGE.
30 * $FreeBSD$
34 * This node permits simple traffic shaping by emulating bandwidth
35 * and delay, as well as random packet losses.
36 * The node has two hooks, upper and lower. Traffic flowing from upper to
37 * lower hook is referenced as downstream, and vice versa. Parameters for
38 * both directions can be set separately, except for delay.
42 #include <sys/param.h>
43 #include <sys/errno.h>
44 #include <sys/systm.h>
45 #include <sys/kernel.h>
46 #include <sys/malloc.h>
47 #include <sys/mbuf.h>
48 #include <sys/time.h>
50 #include <vm/uma.h>
52 #include <net/vnet.h>
54 #include <netinet/in.h>
55 #include <netinet/in_systm.h>
56 #include <netinet/ip.h>
58 #include <netgraph/ng_message.h>
59 #include <netgraph/netgraph.h>
60 #include <netgraph/ng_parse.h>
61 #include <netgraph/ng_pipe.h>
63 static MALLOC_DEFINE(M_NG_PIPE, "ng_pipe", "ng_pipe");
65 /* Packet header struct */
66 struct ngp_hdr {
67 TAILQ_ENTRY(ngp_hdr) ngp_link; /* next pkt in queue */
68 struct timeval when; /* this packet's due time */
69 struct mbuf *m; /* ptr to the packet data */
71 TAILQ_HEAD(p_head, ngp_hdr);
73 /* FIFO queue struct */
74 struct ngp_fifo {
75 TAILQ_ENTRY(ngp_fifo) fifo_le; /* list of active queues only */
76 struct p_head packet_head; /* FIFO queue head */
77 u_int32_t hash; /* flow signature */
78 struct timeval vtime; /* virtual time, for WFQ */
79 u_int32_t rr_deficit; /* for DRR */
80 u_int32_t packets; /* # of packets in this queue */
83 /* Per hook info */
84 struct hookinfo {
85 hook_p hook;
86 int noqueue; /* bypass any processing */
87 TAILQ_HEAD(, ngp_fifo) fifo_head; /* FIFO queues */
88 TAILQ_HEAD(, ngp_hdr) qout_head; /* delay queue head */
89 struct timeval qin_utime;
90 struct ng_pipe_hookcfg cfg;
91 struct ng_pipe_hookrun run;
92 struct ng_pipe_hookstat stats;
93 uint64_t *ber_p; /* loss_p(BER,psize) map */
96 /* Per node info */
97 struct node_priv {
98 u_int64_t delay;
99 u_int32_t overhead;
100 u_int32_t header_offset;
101 struct hookinfo lower;
102 struct hookinfo upper;
103 struct callout timer;
104 int timer_scheduled;
106 typedef struct node_priv *priv_p;
108 /* Macro for calculating the virtual time for packet dequeueing in WFQ */
109 #define FIFO_VTIME_SORT(plen) \
110 if (hinfo->cfg.wfq && hinfo->cfg.bandwidth) { \
111 ngp_f->vtime.tv_usec = now->tv_usec + ((uint64_t) (plen) \
112 + priv->overhead ) * hinfo->run.fifo_queues * \
113 8000000 / hinfo->cfg.bandwidth; \
114 ngp_f->vtime.tv_sec = now->tv_sec + \
115 ngp_f->vtime.tv_usec / 1000000; \
116 ngp_f->vtime.tv_usec = ngp_f->vtime.tv_usec % 1000000; \
117 TAILQ_FOREACH(ngp_f1, &hinfo->fifo_head, fifo_le) \
118 if (ngp_f1->vtime.tv_sec > ngp_f->vtime.tv_sec || \
119 (ngp_f1->vtime.tv_sec == ngp_f->vtime.tv_sec && \
120 ngp_f1->vtime.tv_usec > ngp_f->vtime.tv_usec)) \
121 break; \
122 if (ngp_f1 == NULL) \
123 TAILQ_INSERT_TAIL(&hinfo->fifo_head, ngp_f, fifo_le); \
124 else \
125 TAILQ_INSERT_BEFORE(ngp_f1, ngp_f, fifo_le); \
126 } else \
127 TAILQ_INSERT_TAIL(&hinfo->fifo_head, ngp_f, fifo_le); \
130 static void parse_cfg(struct ng_pipe_hookcfg *, struct ng_pipe_hookcfg *,
131 struct hookinfo *, priv_p);
132 static void pipe_dequeue(struct hookinfo *, struct timeval *);
133 static void ngp_callout(node_p, hook_p, void *, int);
134 static int ngp_modevent(module_t, int, void *);
136 /* zone for storing ngp_hdr-s */
137 static uma_zone_t ngp_zone;
139 /* Netgraph methods */
140 static ng_constructor_t ngp_constructor;
141 static ng_rcvmsg_t ngp_rcvmsg;
142 static ng_shutdown_t ngp_shutdown;
143 static ng_newhook_t ngp_newhook;
144 static ng_rcvdata_t ngp_rcvdata;
145 static ng_disconnect_t ngp_disconnect;
147 /* Parse type for struct ng_pipe_hookstat */
148 static const struct ng_parse_struct_field
149 ng_pipe_hookstat_type_fields[] = NG_PIPE_HOOKSTAT_INFO;
150 static const struct ng_parse_type ng_pipe_hookstat_type = {
151 &ng_parse_struct_type,
152 &ng_pipe_hookstat_type_fields
155 /* Parse type for struct ng_pipe_stats */
156 static const struct ng_parse_struct_field ng_pipe_stats_type_fields[] =
157 NG_PIPE_STATS_INFO(&ng_pipe_hookstat_type);
158 static const struct ng_parse_type ng_pipe_stats_type = {
159 &ng_parse_struct_type,
160 &ng_pipe_stats_type_fields
163 /* Parse type for struct ng_pipe_hookrun */
164 static const struct ng_parse_struct_field
165 ng_pipe_hookrun_type_fields[] = NG_PIPE_HOOKRUN_INFO;
166 static const struct ng_parse_type ng_pipe_hookrun_type = {
167 &ng_parse_struct_type,
168 &ng_pipe_hookrun_type_fields
171 /* Parse type for struct ng_pipe_run */
172 static const struct ng_parse_struct_field
173 ng_pipe_run_type_fields[] = NG_PIPE_RUN_INFO(&ng_pipe_hookrun_type);
174 static const struct ng_parse_type ng_pipe_run_type = {
175 &ng_parse_struct_type,
176 &ng_pipe_run_type_fields
179 /* Parse type for struct ng_pipe_hookcfg */
180 static const struct ng_parse_struct_field
181 ng_pipe_hookcfg_type_fields[] = NG_PIPE_HOOKCFG_INFO;
182 static const struct ng_parse_type ng_pipe_hookcfg_type = {
183 &ng_parse_struct_type,
184 &ng_pipe_hookcfg_type_fields
187 /* Parse type for struct ng_pipe_cfg */
188 static const struct ng_parse_struct_field
189 ng_pipe_cfg_type_fields[] = NG_PIPE_CFG_INFO(&ng_pipe_hookcfg_type);
190 static const struct ng_parse_type ng_pipe_cfg_type = {
191 &ng_parse_struct_type,
192 &ng_pipe_cfg_type_fields
195 /* List of commands and how to convert arguments to/from ASCII */
196 static const struct ng_cmdlist ngp_cmds[] = {
198 .cookie = NGM_PIPE_COOKIE,
199 .cmd = NGM_PIPE_GET_STATS,
200 .name = "getstats",
201 .respType = &ng_pipe_stats_type
204 .cookie = NGM_PIPE_COOKIE,
205 .cmd = NGM_PIPE_CLR_STATS,
206 .name = "clrstats"
209 .cookie = NGM_PIPE_COOKIE,
210 .cmd = NGM_PIPE_GETCLR_STATS,
211 .name = "getclrstats",
212 .respType = &ng_pipe_stats_type
215 .cookie = NGM_PIPE_COOKIE,
216 .cmd = NGM_PIPE_GET_RUN,
217 .name = "getrun",
218 .respType = &ng_pipe_run_type
221 .cookie = NGM_PIPE_COOKIE,
222 .cmd = NGM_PIPE_GET_CFG,
223 .name = "getcfg",
224 .respType = &ng_pipe_cfg_type
227 .cookie = NGM_PIPE_COOKIE,
228 .cmd = NGM_PIPE_SET_CFG,
229 .name = "setcfg",
230 .mesgType = &ng_pipe_cfg_type,
232 { 0 }
235 /* Netgraph type descriptor */
236 static struct ng_type ng_pipe_typestruct = {
237 .version = NG_ABI_VERSION,
238 .name = NG_PIPE_NODE_TYPE,
239 .mod_event = ngp_modevent,
240 .constructor = ngp_constructor,
241 .shutdown = ngp_shutdown,
242 .rcvmsg = ngp_rcvmsg,
243 .newhook = ngp_newhook,
244 .rcvdata = ngp_rcvdata,
245 .disconnect = ngp_disconnect,
246 .cmdlist = ngp_cmds
248 NETGRAPH_INIT(pipe, &ng_pipe_typestruct);
250 /* Node constructor */
251 static int
252 ngp_constructor(node_p node)
254 priv_p priv;
256 priv = malloc(sizeof(*priv), M_NG_PIPE, M_ZERO | M_WAITOK);
257 NG_NODE_SET_PRIVATE(node, priv);
259 /* Mark node as single-threaded */
260 NG_NODE_FORCE_WRITER(node);
262 ng_callout_init(&priv->timer);
264 return (0);
267 /* Add a hook */
268 static int
269 ngp_newhook(node_p node, hook_p hook, const char *name)
271 const priv_p priv = NG_NODE_PRIVATE(node);
272 struct hookinfo *hinfo;
274 if (strcmp(name, NG_PIPE_HOOK_UPPER) == 0) {
275 bzero(&priv->upper, sizeof(priv->upper));
276 priv->upper.hook = hook;
277 NG_HOOK_SET_PRIVATE(hook, &priv->upper);
278 } else if (strcmp(name, NG_PIPE_HOOK_LOWER) == 0) {
279 bzero(&priv->lower, sizeof(priv->lower));
280 priv->lower.hook = hook;
281 NG_HOOK_SET_PRIVATE(hook, &priv->lower);
282 } else
283 return (EINVAL);
285 /* Load non-zero initial cfg values */
286 hinfo = NG_HOOK_PRIVATE(hook);
287 hinfo->cfg.qin_size_limit = 50;
288 hinfo->cfg.fifo = 1;
289 hinfo->cfg.droptail = 1;
290 TAILQ_INIT(&hinfo->fifo_head);
291 TAILQ_INIT(&hinfo->qout_head);
292 return (0);
295 /* Receive a control message */
296 static int
297 ngp_rcvmsg(node_p node, item_p item, hook_p lasthook)
299 const priv_p priv = NG_NODE_PRIVATE(node);
300 struct ng_mesg *resp = NULL;
301 struct ng_mesg *msg, *flow_msg;
302 struct ng_pipe_stats *stats;
303 struct ng_pipe_run *run;
304 struct ng_pipe_cfg *cfg;
305 int error = 0;
306 int prev_down, now_down, cmd;
308 NGI_GET_MSG(item, msg);
309 switch (msg->header.typecookie) {
310 case NGM_PIPE_COOKIE:
311 switch (msg->header.cmd) {
312 case NGM_PIPE_GET_STATS:
313 case NGM_PIPE_CLR_STATS:
314 case NGM_PIPE_GETCLR_STATS:
315 if (msg->header.cmd != NGM_PIPE_CLR_STATS) {
316 NG_MKRESPONSE(resp, msg,
317 sizeof(*stats), M_NOWAIT);
318 if (resp == NULL) {
319 error = ENOMEM;
320 break;
322 stats = (struct ng_pipe_stats *) resp->data;
323 bcopy(&priv->upper.stats, &stats->downstream,
324 sizeof(stats->downstream));
325 bcopy(&priv->lower.stats, &stats->upstream,
326 sizeof(stats->upstream));
328 if (msg->header.cmd != NGM_PIPE_GET_STATS) {
329 bzero(&priv->upper.stats,
330 sizeof(priv->upper.stats));
331 bzero(&priv->lower.stats,
332 sizeof(priv->lower.stats));
334 break;
335 case NGM_PIPE_GET_RUN:
336 NG_MKRESPONSE(resp, msg, sizeof(*run), M_NOWAIT);
337 if (resp == NULL) {
338 error = ENOMEM;
339 break;
341 run = (struct ng_pipe_run *) resp->data;
342 bcopy(&priv->upper.run, &run->downstream,
343 sizeof(run->downstream));
344 bcopy(&priv->lower.run, &run->upstream,
345 sizeof(run->upstream));
346 break;
347 case NGM_PIPE_GET_CFG:
348 NG_MKRESPONSE(resp, msg, sizeof(*cfg), M_NOWAIT);
349 if (resp == NULL) {
350 error = ENOMEM;
351 break;
353 cfg = (struct ng_pipe_cfg *) resp->data;
354 bcopy(&priv->upper.cfg, &cfg->downstream,
355 sizeof(cfg->downstream));
356 bcopy(&priv->lower.cfg, &cfg->upstream,
357 sizeof(cfg->upstream));
358 cfg->delay = priv->delay;
359 cfg->overhead = priv->overhead;
360 cfg->header_offset = priv->header_offset;
361 if (cfg->upstream.bandwidth ==
362 cfg->downstream.bandwidth) {
363 cfg->bandwidth = cfg->upstream.bandwidth;
364 cfg->upstream.bandwidth = 0;
365 cfg->downstream.bandwidth = 0;
366 } else
367 cfg->bandwidth = 0;
368 break;
369 case NGM_PIPE_SET_CFG:
370 cfg = (struct ng_pipe_cfg *) msg->data;
371 if (msg->header.arglen != sizeof(*cfg)) {
372 error = EINVAL;
373 break;
376 if (cfg->delay == -1)
377 priv->delay = 0;
378 else if (cfg->delay > 0 && cfg->delay < 10000000)
379 priv->delay = cfg->delay;
381 if (cfg->bandwidth == -1) {
382 priv->upper.cfg.bandwidth = 0;
383 priv->lower.cfg.bandwidth = 0;
384 priv->overhead = 0;
385 } else if (cfg->bandwidth >= 100 &&
386 cfg->bandwidth <= 1000000000) {
387 priv->upper.cfg.bandwidth = cfg->bandwidth;
388 priv->lower.cfg.bandwidth = cfg->bandwidth;
389 if (cfg->bandwidth >= 10000000)
390 priv->overhead = 8+4+12; /* Ethernet */
391 else
392 priv->overhead = 10; /* HDLC */
395 if (cfg->overhead == -1)
396 priv->overhead = 0;
397 else if (cfg->overhead > 0 &&
398 cfg->overhead < MAX_OHSIZE)
399 priv->overhead = cfg->overhead;
401 if (cfg->header_offset == -1)
402 priv->header_offset = 0;
403 else if (cfg->header_offset > 0 &&
404 cfg->header_offset < 64)
405 priv->header_offset = cfg->header_offset;
407 prev_down = priv->upper.cfg.ber == 1 ||
408 priv->lower.cfg.ber == 1;
409 parse_cfg(&priv->upper.cfg, &cfg->downstream,
410 &priv->upper, priv);
411 parse_cfg(&priv->lower.cfg, &cfg->upstream,
412 &priv->lower, priv);
413 now_down = priv->upper.cfg.ber == 1 ||
414 priv->lower.cfg.ber == 1;
416 if (prev_down != now_down) {
417 if (now_down)
418 cmd = NGM_LINK_IS_DOWN;
419 else
420 cmd = NGM_LINK_IS_UP;
422 if (priv->lower.hook != NULL) {
423 NG_MKMESSAGE(flow_msg, NGM_FLOW_COOKIE,
424 cmd, 0, M_NOWAIT);
425 if (flow_msg != NULL)
426 NG_SEND_MSG_HOOK(error, node,
427 flow_msg, priv->lower.hook,
430 if (priv->upper.hook != NULL) {
431 NG_MKMESSAGE(flow_msg, NGM_FLOW_COOKIE,
432 cmd, 0, M_NOWAIT);
433 if (flow_msg != NULL)
434 NG_SEND_MSG_HOOK(error, node,
435 flow_msg, priv->upper.hook,
439 break;
440 default:
441 error = EINVAL;
442 break;
444 break;
445 default:
446 error = EINVAL;
447 break;
449 NG_RESPOND_MSG(error, node, item, resp);
450 NG_FREE_MSG(msg);
452 return (error);
455 static void
456 parse_cfg(struct ng_pipe_hookcfg *current, struct ng_pipe_hookcfg *new,
457 struct hookinfo *hinfo, priv_p priv)
460 if (new->ber == -1) {
461 current->ber = 0;
462 if (hinfo->ber_p) {
463 free(hinfo->ber_p, M_NG_PIPE);
464 hinfo->ber_p = NULL;
466 } else if (new->ber >= 1 && new->ber <= 1000000000000) {
467 static const uint64_t one = 0x1000000000000; /* = 2^48 */
468 uint64_t p0, p;
469 uint32_t fsize, i;
471 if (hinfo->ber_p == NULL)
472 hinfo->ber_p =
473 malloc((MAX_FSIZE + MAX_OHSIZE) * sizeof(uint64_t),
474 M_NG_PIPE, M_WAITOK);
475 current->ber = new->ber;
478 * For given BER and each frame size N (in bytes) calculate
479 * the probability P_OK that the frame is clean:
481 * P_OK(BER,N) = (1 - 1/BER)^(N*8)
483 * We use a 64-bit fixed-point format with decimal point
484 * positioned between bits 47 and 48.
486 p0 = one - one / new->ber;
487 p = one;
488 for (fsize = 0; fsize < MAX_FSIZE + MAX_OHSIZE; fsize++) {
489 hinfo->ber_p[fsize] = p;
490 for (i = 0; i < 8; i++)
491 p = (p * (p0 & 0xffff) >> 48) +
492 (p * ((p0 >> 16) & 0xffff) >> 32) +
493 (p * (p0 >> 32) >> 16);
497 if (new->qin_size_limit == -1)
498 current->qin_size_limit = 0;
499 else if (new->qin_size_limit >= 5)
500 current->qin_size_limit = new->qin_size_limit;
502 if (new->qout_size_limit == -1)
503 current->qout_size_limit = 0;
504 else if (new->qout_size_limit >= 5)
505 current->qout_size_limit = new->qout_size_limit;
507 if (new->duplicate == -1)
508 current->duplicate = 0;
509 else if (new->duplicate > 0 && new->duplicate <= 50)
510 current->duplicate = new->duplicate;
512 if (new->fifo) {
513 current->fifo = 1;
514 current->wfq = 0;
515 current->drr = 0;
518 if (new->wfq) {
519 current->fifo = 0;
520 current->wfq = 1;
521 current->drr = 0;
524 if (new->drr) {
525 current->fifo = 0;
526 current->wfq = 0;
527 /* DRR quantum */
528 if (new->drr >= 32)
529 current->drr = new->drr;
530 else
531 current->drr = 2048; /* default quantum */
534 if (new->droptail) {
535 current->droptail = 1;
536 current->drophead = 0;
539 if (new->drophead) {
540 current->droptail = 0;
541 current->drophead = 1;
544 if (new->bandwidth == -1) {
545 current->bandwidth = 0;
546 current->fifo = 1;
547 current->wfq = 0;
548 current->drr = 0;
549 } else if (new->bandwidth >= 100 && new->bandwidth <= 1000000000)
550 current->bandwidth = new->bandwidth;
552 if (current->bandwidth | priv->delay |
553 current->duplicate | current->ber)
554 hinfo->noqueue = 0;
555 else
556 hinfo->noqueue = 1;
560 * Compute a hash signature for a packet. This function suffers from the
561 * NIH sindrome, so probably it would be wise to look around what other
562 * folks have found out to be a good and efficient IP hash function...
564 static int
565 ip_hash(struct mbuf *m, int offset)
567 u_int64_t i;
568 struct ip *ip = (struct ip *)(mtod(m, u_char *) + offset);
570 if (m->m_len < sizeof(struct ip) + offset ||
571 ip->ip_v != 4 || ip->ip_hl << 2 != sizeof(struct ip))
572 return 0;
574 i = ((u_int64_t) ip->ip_src.s_addr ^
575 ((u_int64_t) ip->ip_src.s_addr << 13) ^
576 ((u_int64_t) ip->ip_dst.s_addr << 7) ^
577 ((u_int64_t) ip->ip_dst.s_addr << 19));
578 return (i ^ (i >> 32));
582 * Receive data on a hook - both in upstream and downstream direction.
583 * We put the frame on the inbound queue, and try to initiate dequeuing
584 * sequence immediately. If inbound queue is full, discard one frame
585 * depending on dropping policy (from the head or from the tail of the
586 * queue).
588 static int
589 ngp_rcvdata(hook_p hook, item_p item)
591 struct hookinfo *const hinfo = NG_HOOK_PRIVATE(hook);
592 const priv_p priv = NG_NODE_PRIVATE(NG_HOOK_NODE(hook));
593 struct timeval uuptime;
594 struct timeval *now = &uuptime;
595 struct ngp_fifo *ngp_f = NULL, *ngp_f1;
596 struct ngp_hdr *ngp_h = NULL;
597 struct mbuf *m;
598 int hash, plen;
599 int error = 0;
602 * Shortcut from inbound to outbound hook when neither of
603 * bandwidth, delay, BER or duplication probability is
604 * configured, nor we have queued frames to drain.
606 if (hinfo->run.qin_frames == 0 && hinfo->run.qout_frames == 0 &&
607 hinfo->noqueue) {
608 struct hookinfo *dest;
609 if (hinfo == &priv->lower)
610 dest = &priv->upper;
611 else
612 dest = &priv->lower;
614 /* Send the frame. */
615 plen = NGI_M(item)->m_pkthdr.len;
616 NG_FWD_ITEM_HOOK(error, item, dest->hook);
618 /* Update stats. */
619 if (error) {
620 hinfo->stats.out_disc_frames++;
621 hinfo->stats.out_disc_octets += plen;
622 } else {
623 hinfo->stats.fwd_frames++;
624 hinfo->stats.fwd_octets += plen;
627 return (error);
630 microuptime(now);
633 * If this was an empty queue, update service deadline time.
635 if (hinfo->run.qin_frames == 0) {
636 struct timeval *when = &hinfo->qin_utime;
637 if (when->tv_sec < now->tv_sec || (when->tv_sec == now->tv_sec
638 && when->tv_usec < now->tv_usec)) {
639 when->tv_sec = now->tv_sec;
640 when->tv_usec = now->tv_usec;
644 /* Populate the packet header */
645 ngp_h = uma_zalloc(ngp_zone, M_NOWAIT);
646 KASSERT((ngp_h != NULL), ("ngp_h zalloc failed (1)"));
647 NGI_GET_M(item, m);
648 KASSERT(m != NULL, ("NGI_GET_M failed"));
649 ngp_h->m = m;
650 NG_FREE_ITEM(item);
652 if (hinfo->cfg.fifo)
653 hash = 0; /* all packets go into a single FIFO queue */
654 else
655 hash = ip_hash(m, priv->header_offset);
657 /* Find the appropriate FIFO queue for the packet and enqueue it*/
658 TAILQ_FOREACH(ngp_f, &hinfo->fifo_head, fifo_le)
659 if (hash == ngp_f->hash)
660 break;
661 if (ngp_f == NULL) {
662 ngp_f = uma_zalloc(ngp_zone, M_NOWAIT);
663 KASSERT(ngp_h != NULL, ("ngp_h zalloc failed (2)"));
664 TAILQ_INIT(&ngp_f->packet_head);
665 ngp_f->hash = hash;
666 ngp_f->packets = 1;
667 ngp_f->rr_deficit = hinfo->cfg.drr; /* DRR quantum */
668 hinfo->run.fifo_queues++;
669 TAILQ_INSERT_TAIL(&ngp_f->packet_head, ngp_h, ngp_link);
670 FIFO_VTIME_SORT(m->m_pkthdr.len);
671 } else {
672 TAILQ_INSERT_TAIL(&ngp_f->packet_head, ngp_h, ngp_link);
673 ngp_f->packets++;
675 hinfo->run.qin_frames++;
676 hinfo->run.qin_octets += m->m_pkthdr.len;
678 /* Discard a frame if inbound queue limit has been reached */
679 if (hinfo->run.qin_frames > hinfo->cfg.qin_size_limit) {
680 struct mbuf *m1;
681 int longest = 0;
683 /* Find the longest queue */
684 TAILQ_FOREACH(ngp_f1, &hinfo->fifo_head, fifo_le)
685 if (ngp_f1->packets > longest) {
686 longest = ngp_f1->packets;
687 ngp_f = ngp_f1;
690 /* Drop a frame from the queue head/tail, depending on cfg */
691 if (hinfo->cfg.drophead)
692 ngp_h = TAILQ_FIRST(&ngp_f->packet_head);
693 else
694 ngp_h = TAILQ_LAST(&ngp_f->packet_head, p_head);
695 TAILQ_REMOVE(&ngp_f->packet_head, ngp_h, ngp_link);
696 m1 = ngp_h->m;
697 uma_zfree(ngp_zone, ngp_h);
698 hinfo->run.qin_octets -= m1->m_pkthdr.len;
699 hinfo->stats.in_disc_octets += m1->m_pkthdr.len;
700 m_freem(m1);
701 if (--(ngp_f->packets) == 0) {
702 TAILQ_REMOVE(&hinfo->fifo_head, ngp_f, fifo_le);
703 uma_zfree(ngp_zone, ngp_f);
704 hinfo->run.fifo_queues--;
706 hinfo->run.qin_frames--;
707 hinfo->stats.in_disc_frames++;
711 * Try to start the dequeuing process immediately.
713 pipe_dequeue(hinfo, now);
715 return (0);
720 * Dequeueing sequence - we basically do the following:
721 * 1) Try to extract the frame from the inbound (bandwidth) queue;
722 * 2) In accordance to BER specified, discard the frame randomly;
723 * 3) If the frame survives BER, prepend it with delay info and move it
724 * to outbound (delay) queue;
725 * 4) Loop to 2) until bandwidth quota for this timeslice is reached, or
726 * inbound queue is flushed completely;
727 * 5) Dequeue frames from the outbound queue and send them downstream until
728 * outbound queue is flushed completely, or the next frame in the queue
729 * is not due to be dequeued yet
731 static void
732 pipe_dequeue(struct hookinfo *hinfo, struct timeval *now) {
733 static uint64_t rand, oldrand;
734 const node_p node = NG_HOOK_NODE(hinfo->hook);
735 const priv_p priv = NG_NODE_PRIVATE(node);
736 struct hookinfo *dest;
737 struct ngp_fifo *ngp_f, *ngp_f1;
738 struct ngp_hdr *ngp_h;
739 struct timeval *when;
740 struct mbuf *m;
741 int plen, error = 0;
743 /* Which one is the destination hook? */
744 if (hinfo == &priv->lower)
745 dest = &priv->upper;
746 else
747 dest = &priv->lower;
749 /* Bandwidth queue processing */
750 while ((ngp_f = TAILQ_FIRST(&hinfo->fifo_head))) {
751 when = &hinfo->qin_utime;
752 if (when->tv_sec > now->tv_sec || (when->tv_sec == now->tv_sec
753 && when->tv_usec > now->tv_usec))
754 break;
756 ngp_h = TAILQ_FIRST(&ngp_f->packet_head);
757 m = ngp_h->m;
759 /* Deficit Round Robin (DRR) processing */
760 if (hinfo->cfg.drr) {
761 if (ngp_f->rr_deficit >= m->m_pkthdr.len) {
762 ngp_f->rr_deficit -= m->m_pkthdr.len;
763 } else {
764 ngp_f->rr_deficit += hinfo->cfg.drr;
765 TAILQ_REMOVE(&hinfo->fifo_head, ngp_f, fifo_le);
766 TAILQ_INSERT_TAIL(&hinfo->fifo_head,
767 ngp_f, fifo_le);
768 continue;
773 * Either create a duplicate and pass it on, or dequeue
774 * the original packet...
776 if (hinfo->cfg.duplicate &&
777 random() % 100 <= hinfo->cfg.duplicate) {
778 ngp_h = uma_zalloc(ngp_zone, M_NOWAIT);
779 KASSERT(ngp_h != NULL, ("ngp_h zalloc failed (3)"));
780 m = m_dup(m, M_NOWAIT);
781 KASSERT(m != NULL, ("m_dup failed"));
782 ngp_h->m = m;
783 } else {
784 TAILQ_REMOVE(&ngp_f->packet_head, ngp_h, ngp_link);
785 hinfo->run.qin_frames--;
786 hinfo->run.qin_octets -= m->m_pkthdr.len;
787 ngp_f->packets--;
790 /* Calculate the serialization delay */
791 if (hinfo->cfg.bandwidth) {
792 hinfo->qin_utime.tv_usec +=
793 ((uint64_t) m->m_pkthdr.len + priv->overhead ) *
794 8000000 / hinfo->cfg.bandwidth;
795 hinfo->qin_utime.tv_sec +=
796 hinfo->qin_utime.tv_usec / 1000000;
797 hinfo->qin_utime.tv_usec =
798 hinfo->qin_utime.tv_usec % 1000000;
800 when = &ngp_h->when;
801 when->tv_sec = hinfo->qin_utime.tv_sec;
802 when->tv_usec = hinfo->qin_utime.tv_usec;
804 /* Sort / rearrange inbound queues */
805 if (ngp_f->packets) {
806 if (hinfo->cfg.wfq) {
807 TAILQ_REMOVE(&hinfo->fifo_head, ngp_f, fifo_le);
808 FIFO_VTIME_SORT(TAILQ_FIRST(
809 &ngp_f->packet_head)->m->m_pkthdr.len)
811 } else {
812 TAILQ_REMOVE(&hinfo->fifo_head, ngp_f, fifo_le);
813 uma_zfree(ngp_zone, ngp_f);
814 hinfo->run.fifo_queues--;
817 /* Randomly discard the frame, according to BER setting */
818 if (hinfo->cfg.ber) {
819 oldrand = rand;
820 rand = random();
821 if (((oldrand ^ rand) << 17) >=
822 hinfo->ber_p[priv->overhead + m->m_pkthdr.len]) {
823 hinfo->stats.out_disc_frames++;
824 hinfo->stats.out_disc_octets += m->m_pkthdr.len;
825 uma_zfree(ngp_zone, ngp_h);
826 m_freem(m);
827 continue;
831 /* Discard frame if outbound queue size limit exceeded */
832 if (hinfo->cfg.qout_size_limit &&
833 hinfo->run.qout_frames>=hinfo->cfg.qout_size_limit) {
834 hinfo->stats.out_disc_frames++;
835 hinfo->stats.out_disc_octets += m->m_pkthdr.len;
836 uma_zfree(ngp_zone, ngp_h);
837 m_freem(m);
838 continue;
841 /* Calculate the propagation delay */
842 when->tv_usec += priv->delay;
843 when->tv_sec += when->tv_usec / 1000000;
844 when->tv_usec = when->tv_usec % 1000000;
846 /* Put the frame into the delay queue */
847 TAILQ_INSERT_TAIL(&hinfo->qout_head, ngp_h, ngp_link);
848 hinfo->run.qout_frames++;
849 hinfo->run.qout_octets += m->m_pkthdr.len;
852 /* Delay queue processing */
853 while ((ngp_h = TAILQ_FIRST(&hinfo->qout_head))) {
854 when = &ngp_h->when;
855 m = ngp_h->m;
856 if (when->tv_sec > now->tv_sec ||
857 (when->tv_sec == now->tv_sec &&
858 when->tv_usec > now->tv_usec))
859 break;
861 /* Update outbound queue stats */
862 plen = m->m_pkthdr.len;
863 hinfo->run.qout_frames--;
864 hinfo->run.qout_octets -= plen;
866 /* Dequeue the packet from qout */
867 TAILQ_REMOVE(&hinfo->qout_head, ngp_h, ngp_link);
868 uma_zfree(ngp_zone, ngp_h);
870 NG_SEND_DATA(error, dest->hook, m, meta);
871 if (error) {
872 hinfo->stats.out_disc_frames++;
873 hinfo->stats.out_disc_octets += plen;
874 } else {
875 hinfo->stats.fwd_frames++;
876 hinfo->stats.fwd_octets += plen;
880 if ((hinfo->run.qin_frames != 0 || hinfo->run.qout_frames != 0) &&
881 !priv->timer_scheduled) {
882 ng_callout(&priv->timer, node, NULL, 1, ngp_callout, NULL, 0);
883 priv->timer_scheduled = 1;
888 * This routine is called on every clock tick. We poll connected hooks
889 * for queued frames by calling pipe_dequeue().
891 static void
892 ngp_callout(node_p node, hook_p hook, void *arg1, int arg2)
894 const priv_p priv = NG_NODE_PRIVATE(node);
895 struct timeval now;
897 priv->timer_scheduled = 0;
898 microuptime(&now);
899 if (priv->upper.hook != NULL)
900 pipe_dequeue(&priv->upper, &now);
901 if (priv->lower.hook != NULL)
902 pipe_dequeue(&priv->lower, &now);
906 * Shutdown processing
908 * This is tricky. If we have both a lower and upper hook, then we
909 * probably want to extricate ourselves and leave the two peers
910 * still linked to each other. Otherwise we should just shut down as
911 * a normal node would.
913 static int
914 ngp_shutdown(node_p node)
916 const priv_p priv = NG_NODE_PRIVATE(node);
918 if (priv->timer_scheduled)
919 ng_uncallout(&priv->timer, node);
920 if (priv->lower.hook && priv->upper.hook)
921 ng_bypass(priv->lower.hook, priv->upper.hook);
922 else {
923 if (priv->upper.hook != NULL)
924 ng_rmhook_self(priv->upper.hook);
925 if (priv->lower.hook != NULL)
926 ng_rmhook_self(priv->lower.hook);
928 NG_NODE_UNREF(node);
929 free(priv, M_NG_PIPE);
930 return (0);
935 * Hook disconnection
937 static int
938 ngp_disconnect(hook_p hook)
940 struct hookinfo *const hinfo = NG_HOOK_PRIVATE(hook);
941 struct ngp_fifo *ngp_f;
942 struct ngp_hdr *ngp_h;
944 KASSERT(hinfo != NULL, ("%s: null info", __FUNCTION__));
945 hinfo->hook = NULL;
947 /* Flush all fifo queues associated with the hook */
948 while ((ngp_f = TAILQ_FIRST(&hinfo->fifo_head))) {
949 while ((ngp_h = TAILQ_FIRST(&ngp_f->packet_head))) {
950 TAILQ_REMOVE(&ngp_f->packet_head, ngp_h, ngp_link);
951 m_freem(ngp_h->m);
952 uma_zfree(ngp_zone, ngp_h);
954 TAILQ_REMOVE(&hinfo->fifo_head, ngp_f, fifo_le);
955 uma_zfree(ngp_zone, ngp_f);
958 /* Flush the delay queue */
959 while ((ngp_h = TAILQ_FIRST(&hinfo->qout_head))) {
960 TAILQ_REMOVE(&hinfo->qout_head, ngp_h, ngp_link);
961 m_freem(ngp_h->m);
962 uma_zfree(ngp_zone, ngp_h);
965 /* Release the packet loss probability table (BER) */
966 if (hinfo->ber_p)
967 free(hinfo->ber_p, M_NG_PIPE);
969 return (0);
972 static int
973 ngp_modevent(module_t mod, int type, void *unused)
975 int error = 0;
977 switch (type) {
978 case MOD_LOAD:
979 ngp_zone = uma_zcreate("ng_pipe", max(sizeof(struct ngp_hdr),
980 sizeof (struct ngp_fifo)), NULL, NULL, NULL, NULL,
981 UMA_ALIGN_PTR, 0);
982 if (ngp_zone == NULL)
983 panic("ng_pipe: couldn't allocate descriptor zone");
984 break;
985 case MOD_UNLOAD:
986 uma_zdestroy(ngp_zone);
987 break;
988 default:
989 error = EOPNOTSUPP;
990 break;
993 return (error);