2 * Copyright (c) 2015 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at:
7 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
16 * main.c: main vector processing loop
18 * Copyright (c) 2008 Eliot Dresselhaus
20 * Permission is hereby granted, free of charge, to any person obtaining
21 * a copy of this software and associated documentation files (the
22 * "Software"), to deal in the Software without restriction, including
23 * without limitation the rights to use, copy, modify, merge, publish,
24 * distribute, sublicense, and/or sell copies of the Software, and to
25 * permit persons to whom the Software is furnished to do so, subject to
26 * the following conditions:
28 * The above copyright notice and this permission notice shall be
29 * included in all copies or substantial portions of the Software.
31 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
32 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
33 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
34 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
35 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
36 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
37 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
41 #include <vppinfra/format.h>
42 #include <vlib/vlib.h>
43 #include <vlib/threads.h>
44 #include <vppinfra/tw_timer_1t_3w_1024sl_ov.h>
46 #include <vlib/unix/unix.h>
47 #include <vlib/unix/cj.h>
49 CJ_GLOBAL_LOG_PROTOTYPE;
51 /* Actually allocate a few extra slots of vector data to support
52 speculative vector enqueues which overflow vector data in next frame. */
53 #define VLIB_FRAME_SIZE_ALLOC (VLIB_FRAME_SIZE + 4)
58 vlib_frame_bytes (u32 n_scalar_bytes, u32 n_vector_bytes)
62 /* Make room for vlib_frame_t plus scalar arguments. */
63 n_bytes = vlib_frame_vector_byte_offset (n_scalar_bytes);
65 /* Make room for vector arguments.
66 Allocate a few extra slots of vector data to support
67 speculative vector enqueues which overflow vector data in next frame. */
68 #define VLIB_FRAME_SIZE_EXTRA 4
69 n_bytes += (VLIB_FRAME_SIZE + VLIB_FRAME_SIZE_EXTRA) * n_vector_bytes;
71 /* Magic number is first 32bit number after vector data.
72 Used to make sure that vector data is never overrun. */
73 #define VLIB_FRAME_MAGIC (0xabadc0ed)
74 n_bytes += sizeof (u32);
76 /* Pad to cache line. */
77 n_bytes = round_pow2 (n_bytes, CLIB_CACHE_LINE_BYTES);
83 vlib_frame_find_magic (vlib_frame_t * f, vlib_node_t * node)
87 p += vlib_frame_vector_byte_offset (node->scalar_size);
89 p += (VLIB_FRAME_SIZE + VLIB_FRAME_SIZE_EXTRA) * node->vector_size;
94 static vlib_frame_size_t *
95 get_frame_size_info (vlib_node_main_t * nm,
96 u32 n_scalar_bytes, u32 n_vector_bytes)
98 uword key = (n_scalar_bytes << 16) | n_vector_bytes;
101 p = hash_get (nm->frame_size_hash, key);
106 i = vec_len (nm->frame_sizes);
107 vec_validate (nm->frame_sizes, i);
108 hash_set (nm->frame_size_hash, key, i);
111 return vec_elt_at_index (nm->frame_sizes, i);
115 vlib_frame_alloc_to_node (vlib_main_t * vm, u32 to_node_index,
118 vlib_node_main_t *nm = &vm->node_main;
119 vlib_frame_size_t *fs;
120 vlib_node_t *to_node;
122 u32 fi, l, n, scalar_size, vector_size;
124 to_node = vlib_get_node (vm, to_node_index);
126 scalar_size = to_node->scalar_size;
127 vector_size = to_node->vector_size;
129 fs = get_frame_size_info (nm, scalar_size, vector_size);
130 n = vlib_frame_bytes (scalar_size, vector_size);
131 if ((l = vec_len (fs->free_frame_indices)) > 0)
133 /* Allocate from end of free list. */
134 fi = fs->free_frame_indices[l - 1];
135 f = vlib_get_frame_no_check (vm, fi);
136 _vec_len (fs->free_frame_indices) = l - 1;
140 f = clib_mem_alloc_aligned_no_fail (n, VLIB_FRAME_ALIGN);
141 fi = vlib_frame_index_no_check (vm, f);
144 /* Poison frame when debugging. */
146 clib_memset (f, 0xfe, n);
148 /* Insert magic number. */
152 magic = vlib_frame_find_magic (f, to_node);
153 *magic = VLIB_FRAME_MAGIC;
156 f->frame_flags = VLIB_FRAME_IS_ALLOCATED | frame_flags;
158 f->scalar_size = scalar_size;
159 f->vector_size = vector_size;
162 fs->n_alloc_frames += 1;
167 /* Allocate a frame for from FROM_NODE to TO_NODE via TO_NEXT_INDEX.
168 Returns frame index. */
170 vlib_frame_alloc (vlib_main_t * vm, vlib_node_runtime_t * from_node_runtime,
173 vlib_node_t *from_node;
175 from_node = vlib_get_node (vm, from_node_runtime->node_index);
176 ASSERT (to_next_index < vec_len (from_node->next_nodes));
178 return vlib_frame_alloc_to_node (vm, from_node->next_nodes[to_next_index],
179 /* frame_flags */ 0);
183 vlib_get_frame_to_node (vlib_main_t * vm, u32 to_node_index)
185 u32 fi = vlib_frame_alloc_to_node (vm, to_node_index,
187 VLIB_FRAME_FREE_AFTER_DISPATCH);
188 return vlib_get_frame (vm, fi);
192 vlib_put_frame_to_node (vlib_main_t * vm, u32 to_node_index, vlib_frame_t * f)
194 vlib_pending_frame_t *p;
195 vlib_node_t *to_node;
197 if (f->n_vectors == 0)
200 to_node = vlib_get_node (vm, to_node_index);
202 vec_add2 (vm->node_main.pending_frames, p, 1);
204 f->frame_flags |= VLIB_FRAME_PENDING;
205 p->frame_index = vlib_frame_index (vm, f);
206 p->node_runtime_index = to_node->runtime_index;
207 p->next_frame_index = VLIB_PENDING_FRAME_NO_NEXT_FRAME;
210 /* Free given frame. */
212 vlib_frame_free (vlib_main_t * vm, vlib_node_runtime_t * r, vlib_frame_t * f)
214 vlib_node_main_t *nm = &vm->node_main;
216 vlib_frame_size_t *fs;
219 ASSERT (f->frame_flags & VLIB_FRAME_IS_ALLOCATED);
221 node = vlib_get_node (vm, r->node_index);
222 fs = get_frame_size_info (nm, node->scalar_size, node->vector_size);
224 frame_index = vlib_frame_index (vm, f);
226 ASSERT (f->frame_flags & VLIB_FRAME_IS_ALLOCATED);
228 /* No next frames may point to freed frame. */
231 vlib_next_frame_t *nf;
232 vec_foreach (nf, vm->node_main.next_frames)
233 ASSERT (nf->frame_index != frame_index);
236 f->frame_flags &= ~VLIB_FRAME_IS_ALLOCATED;
238 vec_add1 (fs->free_frame_indices, frame_index);
239 ASSERT (fs->n_alloc_frames > 0);
240 fs->n_alloc_frames -= 1;
243 static clib_error_t *
244 show_frame_stats (vlib_main_t * vm,
245 unformat_input_t * input, vlib_cli_command_t * cmd)
247 vlib_node_main_t *nm = &vm->node_main;
248 vlib_frame_size_t *fs;
250 vlib_cli_output (vm, "%=6s%=12s%=12s", "Size", "# Alloc", "# Free");
251 vec_foreach (fs, nm->frame_sizes)
253 u32 n_alloc = fs->n_alloc_frames;
254 u32 n_free = vec_len (fs->free_frame_indices);
256 if (n_alloc + n_free > 0)
257 vlib_cli_output (vm, "%=6d%=12d%=12d",
258 fs - nm->frame_sizes, n_alloc, n_free);
265 VLIB_CLI_COMMAND (show_frame_stats_cli, static) = {
266 .path = "show vlib frame-allocation",
267 .short_help = "Show node dispatch frame statistics",
268 .function = show_frame_stats,
272 /* Change ownership of enqueue rights to given next node. */
274 vlib_next_frame_change_ownership (vlib_main_t * vm,
275 vlib_node_runtime_t * node_runtime,
278 vlib_node_main_t *nm = &vm->node_main;
279 vlib_next_frame_t *next_frame;
280 vlib_node_t *node, *next_node;
282 node = vec_elt (nm->nodes, node_runtime->node_index);
284 /* Only internal & input nodes are allowed to call other nodes. */
285 ASSERT (node->type == VLIB_NODE_TYPE_INTERNAL
286 || node->type == VLIB_NODE_TYPE_INPUT
287 || node->type == VLIB_NODE_TYPE_PROCESS);
289 ASSERT (vec_len (node->next_nodes) == node_runtime->n_next_nodes);
292 vlib_node_runtime_get_next_frame (vm, node_runtime, next_index);
293 next_node = vec_elt (nm->nodes, node->next_nodes[next_index]);
295 if (next_node->owner_node_index != VLIB_INVALID_NODE_INDEX)
297 /* Get frame from previous owner. */
298 vlib_next_frame_t *owner_next_frame;
299 vlib_next_frame_t tmp;
302 vlib_node_get_next_frame (vm,
303 next_node->owner_node_index,
304 next_node->owner_next_index);
306 /* Swap target next frame with owner's. */
307 tmp = owner_next_frame[0];
308 owner_next_frame[0] = next_frame[0];
312 * If next_frame is already pending, we have to track down
313 * all pending frames and fix their next_frame_index fields.
315 if (next_frame->flags & VLIB_FRAME_PENDING)
317 vlib_pending_frame_t *p;
318 if (next_frame->frame_index != ~0)
320 vec_foreach (p, nm->pending_frames)
322 if (p->frame_index == next_frame->frame_index)
324 p->next_frame_index =
325 next_frame - vm->node_main.next_frames;
333 /* No previous owner. Take ownership. */
334 next_frame->flags |= VLIB_FRAME_OWNER;
337 /* Record new owner. */
338 next_node->owner_node_index = node->index;
339 next_node->owner_next_index = next_index;
341 /* Now we should be owner. */
342 ASSERT (next_frame->flags & VLIB_FRAME_OWNER);
345 /* Make sure that magic number is still there.
346 Otherwise, it is likely that caller has overrun frame arguments. */
348 validate_frame_magic (vlib_main_t * vm,
349 vlib_frame_t * f, vlib_node_t * n, uword next_index)
351 vlib_node_t *next_node = vlib_get_node (vm, n->next_nodes[next_index]);
352 u32 *magic = vlib_frame_find_magic (f, next_node);
353 ASSERT (VLIB_FRAME_MAGIC == magic[0]);
357 vlib_get_next_frame_internal (vlib_main_t * vm,
358 vlib_node_runtime_t * node,
359 u32 next_index, u32 allocate_new_next_frame)
362 vlib_next_frame_t *nf;
365 nf = vlib_node_runtime_get_next_frame (vm, node, next_index);
367 /* Make sure this next frame owns right to enqueue to destination frame. */
368 if (PREDICT_FALSE (!(nf->flags & VLIB_FRAME_OWNER)))
369 vlib_next_frame_change_ownership (vm, node, next_index);
371 /* ??? Don't need valid flag: can use frame_index == ~0 */
372 if (PREDICT_FALSE (!(nf->flags & VLIB_FRAME_IS_ALLOCATED)))
374 nf->frame_index = vlib_frame_alloc (vm, node, next_index);
375 nf->flags |= VLIB_FRAME_IS_ALLOCATED;
378 f = vlib_get_frame (vm, nf->frame_index);
380 /* Has frame been removed from pending vector (e.g. finished dispatching)?
381 If so we can reuse frame. */
382 if ((nf->flags & VLIB_FRAME_PENDING)
383 && !(f->frame_flags & VLIB_FRAME_PENDING))
385 nf->flags &= ~VLIB_FRAME_PENDING;
390 /* Allocate new frame if current one is already full. */
391 n_used = f->n_vectors;
392 if (n_used >= VLIB_FRAME_SIZE || (allocate_new_next_frame && n_used > 0))
394 /* Old frame may need to be freed after dispatch, since we'll have
395 two redundant frames from node -> next node. */
396 if (!(nf->flags & VLIB_FRAME_NO_FREE_AFTER_DISPATCH))
398 vlib_frame_t *f_old = vlib_get_frame (vm, nf->frame_index);
399 f_old->frame_flags |= VLIB_FRAME_FREE_AFTER_DISPATCH;
402 /* Allocate new frame to replace full one. */
403 nf->frame_index = vlib_frame_alloc (vm, node, next_index);
404 f = vlib_get_frame (vm, nf->frame_index);
405 n_used = f->n_vectors;
408 /* Should have free vectors in frame now. */
409 ASSERT (n_used < VLIB_FRAME_SIZE);
413 validate_frame_magic (vm, f,
414 vlib_get_node (vm, node->node_index), next_index);
421 vlib_put_next_frame_validate (vlib_main_t * vm,
422 vlib_node_runtime_t * rt,
423 u32 next_index, u32 n_vectors_left)
425 vlib_node_main_t *nm = &vm->node_main;
426 vlib_next_frame_t *nf;
428 vlib_node_runtime_t *next_rt;
429 vlib_node_t *next_node;
430 u32 n_before, n_after;
432 nf = vlib_node_runtime_get_next_frame (vm, rt, next_index);
433 f = vlib_get_frame (vm, nf->frame_index);
435 ASSERT (n_vectors_left <= VLIB_FRAME_SIZE);
436 n_after = VLIB_FRAME_SIZE - n_vectors_left;
437 n_before = f->n_vectors;
439 ASSERT (n_after >= n_before);
441 next_rt = vec_elt_at_index (nm->nodes_by_type[VLIB_NODE_TYPE_INTERNAL],
442 nf->node_runtime_index);
443 next_node = vlib_get_node (vm, next_rt->node_index);
444 if (n_after > 0 && next_node->validate_frame)
446 u8 *msg = next_node->validate_frame (vm, rt, f);
449 clib_warning ("%v", msg);
457 vlib_put_next_frame (vlib_main_t * vm,
458 vlib_node_runtime_t * r,
459 u32 next_index, u32 n_vectors_left)
461 vlib_node_main_t *nm = &vm->node_main;
462 vlib_next_frame_t *nf;
464 u32 n_vectors_in_frame;
466 if (buffer_main.callbacks_registered == 0 && CLIB_DEBUG > 0)
467 vlib_put_next_frame_validate (vm, r, next_index, n_vectors_left);
469 nf = vlib_node_runtime_get_next_frame (vm, r, next_index);
470 f = vlib_get_frame (vm, nf->frame_index);
472 /* Make sure that magic number is still there. Otherwise, caller
473 has overrun frame meta data. */
476 vlib_node_t *node = vlib_get_node (vm, r->node_index);
477 validate_frame_magic (vm, f, node, next_index);
480 /* Convert # of vectors left -> number of vectors there. */
481 ASSERT (n_vectors_left <= VLIB_FRAME_SIZE);
482 n_vectors_in_frame = VLIB_FRAME_SIZE - n_vectors_left;
484 f->n_vectors = n_vectors_in_frame;
486 /* If vectors were added to frame, add to pending vector. */
487 if (PREDICT_TRUE (n_vectors_in_frame > 0))
489 vlib_pending_frame_t *p;
492 r->cached_next_index = next_index;
494 if (!(f->frame_flags & VLIB_FRAME_PENDING))
496 __attribute__ ((unused)) vlib_node_t *node;
497 vlib_node_t *next_node;
498 vlib_node_runtime_t *next_runtime;
500 node = vlib_get_node (vm, r->node_index);
501 next_node = vlib_get_next_node (vm, r->node_index, next_index);
502 next_runtime = vlib_node_get_runtime (vm, next_node->index);
504 vec_add2 (nm->pending_frames, p, 1);
506 p->frame_index = nf->frame_index;
507 p->node_runtime_index = nf->node_runtime_index;
508 p->next_frame_index = nf - nm->next_frames;
509 nf->flags |= VLIB_FRAME_PENDING;
510 f->frame_flags |= VLIB_FRAME_PENDING;
513 * If we're going to dispatch this frame on another thread,
514 * force allocation of a new frame. Otherwise, we create
515 * a dangling frame reference. Each thread has its own copy of
516 * the next_frames vector.
518 if (0 && r->thread_index != next_runtime->thread_index)
520 nf->frame_index = ~0;
521 nf->flags &= ~(VLIB_FRAME_PENDING | VLIB_FRAME_IS_ALLOCATED);
525 /* Copy trace flag from next_frame and from runtime. */
527 (nf->flags & VLIB_NODE_FLAG_TRACE) | (r->
528 flags & VLIB_NODE_FLAG_TRACE);
530 v0 = nf->vectors_since_last_overflow;
531 v1 = v0 + n_vectors_in_frame;
532 nf->vectors_since_last_overflow = v1;
533 if (PREDICT_FALSE (v1 < v0))
535 vlib_node_t *node = vlib_get_node (vm, r->node_index);
536 vec_elt (node->n_vectors_by_next_node, next_index) += v0;
541 /* Sync up runtime (32 bit counters) and main node stats (64 bit counters). */
543 vlib_node_runtime_sync_stats (vlib_main_t * vm,
544 vlib_node_runtime_t * r,
545 uword n_calls, uword n_vectors, uword n_clocks,
548 vlib_node_t *n = vlib_get_node (vm, r->node_index);
550 n->stats_total.calls += n_calls + r->calls_since_last_overflow;
551 n->stats_total.vectors += n_vectors + r->vectors_since_last_overflow;
552 n->stats_total.clocks += n_clocks + r->clocks_since_last_overflow;
553 n->stats_total.perf_counter_ticks += n_ticks +
554 r->perf_counter_ticks_since_last_overflow;
555 n->stats_total.perf_counter_vectors += n_vectors +
556 r->perf_counter_vectors_since_last_overflow;
557 n->stats_total.max_clock = r->max_clock;
558 n->stats_total.max_clock_n = r->max_clock_n;
560 r->calls_since_last_overflow = 0;
561 r->vectors_since_last_overflow = 0;
562 r->clocks_since_last_overflow = 0;
563 r->perf_counter_ticks_since_last_overflow = 0ULL;
564 r->perf_counter_vectors_since_last_overflow = 0ULL;
567 always_inline void __attribute__ ((unused))
568 vlib_process_sync_stats (vlib_main_t * vm,
570 uword n_calls, uword n_vectors, uword n_clocks,
573 vlib_node_runtime_t *rt = &p->node_runtime;
574 vlib_node_t *n = vlib_get_node (vm, rt->node_index);
575 vlib_node_runtime_sync_stats (vm, rt, n_calls, n_vectors, n_clocks,
577 n->stats_total.suspends += p->n_suspends;
582 vlib_node_sync_stats (vlib_main_t * vm, vlib_node_t * n)
584 vlib_node_runtime_t *rt;
586 if (n->type == VLIB_NODE_TYPE_PROCESS)
588 /* Nothing to do for PROCESS nodes except in main thread */
589 if (vm != &vlib_global_main)
592 vlib_process_t *p = vlib_get_process_from_node (vm, n);
593 n->stats_total.suspends += p->n_suspends;
595 rt = &p->node_runtime;
599 vec_elt_at_index (vm->node_main.nodes_by_type[n->type],
602 vlib_node_runtime_sync_stats (vm, rt, 0, 0, 0, 0);
604 /* Sync up runtime next frame vector counters with main node structure. */
606 vlib_next_frame_t *nf;
608 for (i = 0; i < rt->n_next_nodes; i++)
610 nf = vlib_node_runtime_get_next_frame (vm, rt, i);
611 vec_elt (n->n_vectors_by_next_node, i) +=
612 nf->vectors_since_last_overflow;
613 nf->vectors_since_last_overflow = 0;
619 vlib_node_runtime_update_stats (vlib_main_t * vm,
620 vlib_node_runtime_t * node,
622 uword n_vectors, uword n_clocks,
625 u32 ca0, ca1, v0, v1, cl0, cl1, r;
626 u32 ptick0, ptick1, pvec0, pvec1;
628 cl0 = cl1 = node->clocks_since_last_overflow;
629 ca0 = ca1 = node->calls_since_last_overflow;
630 v0 = v1 = node->vectors_since_last_overflow;
631 ptick0 = ptick1 = node->perf_counter_ticks_since_last_overflow;
632 pvec0 = pvec1 = node->perf_counter_vectors_since_last_overflow;
636 cl1 = cl0 + n_clocks;
637 ptick1 = ptick0 + n_ticks;
638 pvec1 = pvec0 + n_vectors;
640 node->calls_since_last_overflow = ca1;
641 node->clocks_since_last_overflow = cl1;
642 node->vectors_since_last_overflow = v1;
643 node->perf_counter_ticks_since_last_overflow = ptick1;
644 node->perf_counter_vectors_since_last_overflow = pvec1;
646 node->max_clock_n = node->max_clock > n_clocks ?
647 node->max_clock_n : n_vectors;
648 node->max_clock = node->max_clock > n_clocks ? node->max_clock : n_clocks;
650 r = vlib_node_runtime_update_main_loop_vector_stats (vm, node, n_vectors);
652 if (PREDICT_FALSE (ca1 < ca0 || v1 < v0 || cl1 < cl0) || (ptick1 < ptick0)
655 node->calls_since_last_overflow = ca0;
656 node->clocks_since_last_overflow = cl0;
657 node->vectors_since_last_overflow = v0;
658 node->perf_counter_ticks_since_last_overflow = ptick0;
659 node->perf_counter_vectors_since_last_overflow = pvec0;
661 vlib_node_runtime_sync_stats (vm, node, n_calls, n_vectors, n_clocks,
669 vlib_node_runtime_perf_counter (vlib_main_t * vm)
671 if (PREDICT_FALSE (vm->vlib_node_runtime_perf_counter_cb != 0))
672 return ((*vm->vlib_node_runtime_perf_counter_cb) (vm));
677 vlib_process_update_stats (vlib_main_t * vm,
679 uword n_calls, uword n_vectors, uword n_clocks,
682 vlib_node_runtime_update_stats (vm, &p->node_runtime,
683 n_calls, n_vectors, n_clocks, n_ticks);
686 static clib_error_t *
687 vlib_cli_elog_clear (vlib_main_t * vm,
688 unformat_input_t * input, vlib_cli_command_t * cmd)
690 elog_reset_buffer (&vm->elog_main);
695 VLIB_CLI_COMMAND (elog_clear_cli, static) = {
696 .path = "event-logger clear",
697 .short_help = "Clear the event log",
698 .function = vlib_cli_elog_clear,
703 static clib_error_t *
704 elog_save_buffer (vlib_main_t * vm,
705 unformat_input_t * input, vlib_cli_command_t * cmd)
707 elog_main_t *em = &vm->elog_main;
708 char *file, *chroot_file;
709 clib_error_t *error = 0;
711 if (!unformat (input, "%s", &file))
713 vlib_cli_output (vm, "expected file name, got `%U'",
714 format_unformat_error, input);
718 /* It's fairly hard to get "../oopsie" through unformat; just in case */
719 if (strstr (file, "..") || index (file, '/'))
721 vlib_cli_output (vm, "illegal characters in filename '%s'", file);
725 chroot_file = (char *) format (0, "/tmp/%s%c", file, 0);
729 vlib_cli_output (vm, "Saving %wd of %wd events to %s",
730 elog_n_events_in_buffer (em),
731 elog_buffer_capacity (em), chroot_file);
733 vlib_worker_thread_barrier_sync (vm);
734 error = elog_write_file (em, chroot_file, 1 /* flush ring */ );
735 vlib_worker_thread_barrier_release (vm);
736 vec_free (chroot_file);
741 elog_post_mortem_dump (void)
743 vlib_main_t *vm = &vlib_global_main;
744 elog_main_t *em = &vm->elog_main;
748 if (!vm->elog_post_mortem_dump)
751 filename = format (0, "/tmp/elog_post_mortem.%d%c", getpid (), 0);
752 error = elog_write_file (em, (char *) filename, 1 /* flush ring */ );
754 clib_error_report (error);
759 VLIB_CLI_COMMAND (elog_save_cli, static) = {
760 .path = "event-logger save",
761 .short_help = "event-logger save <filename> (saves log in /tmp/<filename>)",
762 .function = elog_save_buffer,
766 static clib_error_t *
767 elog_stop (vlib_main_t * vm,
768 unformat_input_t * input, vlib_cli_command_t * cmd)
770 elog_main_t *em = &vm->elog_main;
772 em->n_total_events_disable_limit = em->n_total_events;
774 vlib_cli_output (vm, "Stopped the event logger...");
779 VLIB_CLI_COMMAND (elog_stop_cli, static) = {
780 .path = "event-logger stop",
781 .short_help = "Stop the event-logger",
782 .function = elog_stop,
786 static clib_error_t *
787 elog_restart (vlib_main_t * vm,
788 unformat_input_t * input, vlib_cli_command_t * cmd)
790 elog_main_t *em = &vm->elog_main;
792 em->n_total_events_disable_limit = ~0;
794 vlib_cli_output (vm, "Restarted the event logger...");
799 VLIB_CLI_COMMAND (elog_restart_cli, static) = {
800 .path = "event-logger restart",
801 .short_help = "Restart the event-logger",
802 .function = elog_restart,
806 static clib_error_t *
807 elog_resize (vlib_main_t * vm,
808 unformat_input_t * input, vlib_cli_command_t * cmd)
810 elog_main_t *em = &vm->elog_main;
813 /* Stop the parade */
814 elog_reset_buffer (&vm->elog_main);
816 if (unformat (input, "%d", &tmp))
818 elog_alloc (em, tmp);
819 em->n_total_events_disable_limit = ~0;
822 return clib_error_return (0, "Must specify how many events in the ring");
824 vlib_cli_output (vm, "Resized ring and restarted the event logger...");
829 VLIB_CLI_COMMAND (elog_resize_cli, static) = {
830 .path = "event-logger resize",
831 .short_help = "event-logger resize <nnn>",
832 .function = elog_resize,
836 #endif /* CLIB_UNIX */
839 elog_show_buffer_internal (vlib_main_t * vm, u32 n_events_to_show)
841 elog_main_t *em = &vm->elog_main;
842 elog_event_t *e, *es;
845 /* Show events in VLIB time since log clock starts after VLIB clock. */
846 dt = (em->init_time.cpu - vm->clib_time.init_cpu_time)
847 * vm->clib_time.seconds_per_clock;
849 es = elog_peek_events (em);
850 vlib_cli_output (vm, "%d of %d events in buffer, logger %s", vec_len (es),
852 em->n_total_events < em->n_total_events_disable_limit ?
853 "running" : "stopped");
856 vlib_cli_output (vm, "%18.9f: %U",
857 e->time + dt, format_elog_event, em, e);
859 if (n_events_to_show == 0)
866 static clib_error_t *
867 elog_show_buffer (vlib_main_t * vm,
868 unformat_input_t * input, vlib_cli_command_t * cmd)
870 u32 n_events_to_show;
871 clib_error_t *error = 0;
873 n_events_to_show = 250;
874 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
876 if (unformat (input, "%d", &n_events_to_show))
878 else if (unformat (input, "all"))
879 n_events_to_show = ~0;
881 return unformat_parse_error (input);
883 elog_show_buffer_internal (vm, n_events_to_show);
888 VLIB_CLI_COMMAND (elog_show_cli, static) = {
889 .path = "show event-logger",
890 .short_help = "Show event logger info",
891 .function = elog_show_buffer,
896 vlib_gdb_show_event_log (void)
898 elog_show_buffer_internal (vlib_get_main (), (u32) ~ 0);
902 vlib_elog_main_loop_event (vlib_main_t * vm,
904 u64 time, u32 n_vectors, u32 is_return)
906 vlib_main_t *evm = &vlib_global_main;
907 elog_main_t *em = &evm->elog_main;
909 if (VLIB_ELOG_MAIN_LOOP && n_vectors)
912 vec_elt_at_index (is_return
913 ? evm->node_return_elog_event_types
914 : evm->node_call_elog_event_types,
917 (vm->thread_index ? &vlib_worker_threads[vm->thread_index].
918 elog_track : &em->default_track),
919 /* data to log */ n_vectors);
922 #if VLIB_BUFFER_TRACE_TRAJECTORY > 0
923 void (*vlib_buffer_trace_trajectory_cb) (vlib_buffer_t * b, u32 node_index);
924 void (*vlib_buffer_trace_trajectory_init_cb) (vlib_buffer_t * b);
927 vlib_buffer_trace_trajectory_init (vlib_buffer_t * b)
929 if (PREDICT_TRUE (vlib_buffer_trace_trajectory_init_cb != 0))
931 (*vlib_buffer_trace_trajectory_init_cb) (b);
938 add_trajectory_trace (vlib_buffer_t * b, u32 node_index)
940 #if VLIB_BUFFER_TRACE_TRAJECTORY > 0
941 if (PREDICT_TRUE (vlib_buffer_trace_trajectory_cb != 0))
943 (*vlib_buffer_trace_trajectory_cb) (b, node_index);
949 dispatch_pcap_trace (vlib_main_t * vm,
950 vlib_node_runtime_t * node, vlib_frame_t * frame)
953 vlib_buffer_t *bufs[VLIB_FRAME_SIZE], **bufp, *b;
955 pcap_main_t *pm = &vm->dispatch_pcap_main;
959 f64 time_now = vlib_time_now (vm);
964 /* Input nodes don't have frames yet */
965 if (frame == 0 || frame->n_vectors == 0)
968 from = vlib_frame_vector_args (frame);
969 vlib_get_buffers (vm, from, bufs, frame->n_vectors);
972 /* Create a node name TLV, since WS can't possibly guess */
973 n = vlib_get_node (vm, node->node_index);
974 name_length = vec_len (n->name);
975 name_length = name_length < ARRAY_LEN (name_tlv) - 2 ?
976 name_length : ARRAY_LEN (name_tlv) - 2;
978 name_tlv[0] = (u8) name_length;
979 clib_memcpy_fast (name_tlv + 1, n->name, name_length);
980 name_tlv[name_length + 1] = 0;
982 for (i = 0; i < frame->n_vectors; i++)
984 if (PREDICT_TRUE (pm->n_packets_captured < pm->n_packets_to_capture))
988 /* Figure out how many bytes we're capturing */
989 capture_size = (sizeof (vlib_buffer_t) - VLIB_BUFFER_PRE_DATA_SIZE) + vlib_buffer_length_in_chain (vm, b) + sizeof (u32) + +(name_length + 2); /* +2: count plus NULL byte */
991 clib_spinlock_lock_if_init (&pm->lock);
992 n_left = clib_min (capture_size, 512);
993 d = pcap_add_packet (pm, time_now, n_left, capture_size);
995 /* Copy the buffer index */
996 clib_memcpy_fast (d, &from[i], sizeof (u32));
999 /* Copy the name TLV */
1000 clib_memcpy_fast (d, name_tlv, name_length + 2);
1001 d += name_length + 2;
1003 /* Copy the buffer metadata, but not the rewrite space */
1004 clib_memcpy_fast (d, b, sizeof (*b) - VLIB_BUFFER_PRE_DATA_SIZE);
1005 d += sizeof (*b) - VLIB_BUFFER_PRE_DATA_SIZE;
1007 n_left = clib_min (vlib_buffer_length_in_chain (vm, b),
1008 512 - (sizeof (*b) - VLIB_BUFFER_PRE_DATA_SIZE));
1009 /* Copy the packet data */
1012 u32 copy_length = clib_min ((u32) n_left, b->current_length);
1013 clib_memcpy_fast (d, b->data + b->current_data, copy_length);
1014 n_left -= b->current_length;
1017 d += b->current_length;
1018 ASSERT (b->flags & VLIB_BUFFER_NEXT_PRESENT);
1019 b = vlib_get_buffer (vm, b->next_buffer);
1021 clib_spinlock_unlock_if_init (&pm->lock);
1026 static_always_inline u64
1027 dispatch_node (vlib_main_t * vm,
1028 vlib_node_runtime_t * node,
1029 vlib_node_type_t type,
1030 vlib_node_state_t dispatch_state,
1031 vlib_frame_t * frame, u64 last_time_stamp)
1035 vlib_node_main_t *nm = &vm->node_main;
1036 vlib_next_frame_t *nf;
1040 vlib_node_t *n = vlib_get_node (vm, node->node_index);
1041 ASSERT (n->type == type);
1044 /* Only non-internal nodes may be disabled. */
1045 if (type != VLIB_NODE_TYPE_INTERNAL && node->state != dispatch_state)
1047 ASSERT (type != VLIB_NODE_TYPE_INTERNAL);
1048 return last_time_stamp;
1051 if ((type == VLIB_NODE_TYPE_PRE_INPUT || type == VLIB_NODE_TYPE_INPUT)
1052 && dispatch_state != VLIB_NODE_STATE_INTERRUPT)
1054 u32 c = node->input_main_loops_per_call;
1055 /* Only call node when count reaches zero. */
1058 node->input_main_loops_per_call = c - 1;
1059 return last_time_stamp;
1063 /* Speculatively prefetch next frames. */
1064 if (node->n_next_nodes > 0)
1066 nf = vec_elt_at_index (nm->next_frames, node->next_frame_index);
1067 CLIB_PREFETCH (nf, 4 * sizeof (nf[0]), WRITE);
1070 vm->cpu_time_last_node_dispatch = last_time_stamp;
1072 if (1 /* || vm->thread_index == node->thread_index */ )
1074 u64 pmc_before, pmc_delta;
1076 vlib_elog_main_loop_event (vm, node->node_index,
1078 frame ? frame->n_vectors : 0,
1082 * To validate accounting: pmc_before = last_time_stamp
1083 * perf ticks should equal clocks/pkt...
1085 pmc_before = vlib_node_runtime_perf_counter (vm);
1088 * Turn this on if you run into
1089 * "bad monkey" contexts, and you want to know exactly
1090 * which nodes they've visited... See ixge.c...
1092 if (VLIB_BUFFER_TRACE_TRAJECTORY && frame)
1096 from = vlib_frame_vector_args (frame);
1097 for (i = 0; i < frame->n_vectors; i++)
1099 vlib_buffer_t *b = vlib_get_buffer (vm, from[i]);
1100 add_trajectory_trace (b, node->node_index);
1102 if (PREDICT_FALSE (vm->dispatch_pcap_enable))
1103 dispatch_pcap_trace (vm, node, frame);
1104 n = node->function (vm, node, frame);
1108 if (PREDICT_FALSE (vm->dispatch_pcap_enable))
1109 dispatch_pcap_trace (vm, node, frame);
1110 n = node->function (vm, node, frame);
1113 t = clib_cpu_time_now ();
1116 * To validate accounting: pmc_delta = t - pmc_before;
1117 * perf ticks should equal clocks/pkt...
1119 pmc_delta = vlib_node_runtime_perf_counter (vm) - pmc_before;
1121 vlib_elog_main_loop_event (vm, node->node_index, t, n, /* is_after */
1124 vm->main_loop_vectors_processed += n;
1125 vm->main_loop_nodes_processed += n > 0;
1127 v = vlib_node_runtime_update_stats (vm, node,
1130 /* n_clocks */ t - last_time_stamp,
1131 pmc_delta /* PMC ticks */ );
1133 /* When in interrupt mode and vector rate crosses threshold switch to
1135 if ((dispatch_state == VLIB_NODE_STATE_INTERRUPT)
1136 || (dispatch_state == VLIB_NODE_STATE_POLLING
1138 & VLIB_NODE_FLAG_SWITCH_FROM_INTERRUPT_TO_POLLING_MODE)))
1140 #ifdef DISPATCH_NODE_ELOG_REQUIRED
1141 ELOG_TYPE_DECLARE (e) =
1143 .function = (char *) __FUNCTION__,.format =
1144 "%s vector length %d, switching to %s",.format_args =
1145 "T4i4t4",.n_enum_strings = 2,.enum_strings =
1147 "interrupt", "polling",},};
1150 u32 node_name, vector_length, is_polling;
1152 vlib_worker_thread_t *w = vlib_worker_threads + vm->thread_index;
1155 if ((dispatch_state == VLIB_NODE_STATE_INTERRUPT
1156 && v >= nm->polling_threshold_vector_length) &&
1158 VLIB_NODE_FLAG_SWITCH_FROM_INTERRUPT_TO_POLLING_MODE))
1160 vlib_node_t *n = vlib_get_node (vm, node->node_index);
1161 n->state = VLIB_NODE_STATE_POLLING;
1162 node->state = VLIB_NODE_STATE_POLLING;
1164 ~VLIB_NODE_FLAG_SWITCH_FROM_POLLING_TO_INTERRUPT_MODE;
1166 VLIB_NODE_FLAG_SWITCH_FROM_INTERRUPT_TO_POLLING_MODE;
1167 nm->input_node_counts_by_state[VLIB_NODE_STATE_INTERRUPT] -= 1;
1168 nm->input_node_counts_by_state[VLIB_NODE_STATE_POLLING] += 1;
1170 #ifdef DISPATCH_NODE_ELOG_REQUIRED
1171 ed = ELOG_TRACK_DATA (&vlib_global_main.elog_main, e,
1173 ed->node_name = n->name_elog_string;
1174 ed->vector_length = v;
1178 else if (dispatch_state == VLIB_NODE_STATE_POLLING
1179 && v <= nm->interrupt_threshold_vector_length)
1181 vlib_node_t *n = vlib_get_node (vm, node->node_index);
1183 VLIB_NODE_FLAG_SWITCH_FROM_POLLING_TO_INTERRUPT_MODE)
1185 /* Switch to interrupt mode after dispatch in polling one more time.
1186 This allows driver to re-enable interrupts. */
1187 n->state = VLIB_NODE_STATE_INTERRUPT;
1188 node->state = VLIB_NODE_STATE_INTERRUPT;
1190 ~VLIB_NODE_FLAG_SWITCH_FROM_INTERRUPT_TO_POLLING_MODE;
1191 nm->input_node_counts_by_state[VLIB_NODE_STATE_POLLING] -=
1193 nm->input_node_counts_by_state[VLIB_NODE_STATE_INTERRUPT] +=
1200 VLIB_NODE_FLAG_SWITCH_FROM_POLLING_TO_INTERRUPT_MODE;
1201 #ifdef DISPATCH_NODE_ELOG_REQUIRED
1202 ed = ELOG_TRACK_DATA (&vlib_global_main.elog_main, e,
1204 ed->node_name = n->name_elog_string;
1205 ed->vector_length = v;
1217 dispatch_pending_node (vlib_main_t * vm, uword pending_frame_index,
1218 u64 last_time_stamp)
1220 vlib_node_main_t *nm = &vm->node_main;
1222 vlib_next_frame_t *nf, nf_dummy;
1223 vlib_node_runtime_t *n;
1224 u32 restore_frame_index;
1225 vlib_pending_frame_t *p;
1227 /* See comment below about dangling references to nm->pending_frames */
1228 p = nm->pending_frames + pending_frame_index;
1230 n = vec_elt_at_index (nm->nodes_by_type[VLIB_NODE_TYPE_INTERNAL],
1231 p->node_runtime_index);
1233 f = vlib_get_frame (vm, p->frame_index);
1234 if (p->next_frame_index == VLIB_PENDING_FRAME_NO_NEXT_FRAME)
1236 /* No next frame: so use dummy on stack. */
1238 nf->flags = f->frame_flags & VLIB_NODE_FLAG_TRACE;
1239 nf->frame_index = ~p->frame_index;
1242 nf = vec_elt_at_index (nm->next_frames, p->next_frame_index);
1244 ASSERT (f->frame_flags & VLIB_FRAME_IS_ALLOCATED);
1246 /* Force allocation of new frame while current frame is being
1248 restore_frame_index = ~0;
1249 if (nf->frame_index == p->frame_index)
1251 nf->frame_index = ~0;
1252 nf->flags &= ~VLIB_FRAME_IS_ALLOCATED;
1253 if (!(n->flags & VLIB_NODE_FLAG_FRAME_NO_FREE_AFTER_DISPATCH))
1254 restore_frame_index = p->frame_index;
1257 /* Frame must be pending. */
1258 ASSERT (f->frame_flags & VLIB_FRAME_PENDING);
1259 ASSERT (f->n_vectors > 0);
1261 /* Copy trace flag from next frame to node.
1262 Trace flag indicates that at least one vector in the dispatched
1264 n->flags &= ~VLIB_NODE_FLAG_TRACE;
1265 n->flags |= (nf->flags & VLIB_FRAME_TRACE) ? VLIB_NODE_FLAG_TRACE : 0;
1266 nf->flags &= ~VLIB_FRAME_TRACE;
1268 last_time_stamp = dispatch_node (vm, n,
1269 VLIB_NODE_TYPE_INTERNAL,
1270 VLIB_NODE_STATE_POLLING,
1271 f, last_time_stamp);
1273 f->frame_flags &= ~VLIB_FRAME_PENDING;
1275 /* Frame is ready to be used again, so restore it. */
1276 if (restore_frame_index != ~0)
1279 * We musn't restore a frame that is flagged to be freed. This
1280 * shouldn't happen since frames to be freed post dispatch are
1281 * those used when the to-node frame becomes full i.e. they form a
1282 * sort of queue of frames to a single node. If we get here then
1283 * the to-node frame and the pending frame *were* the same, and so
1284 * we removed the to-node frame. Therefore this frame is no
1285 * longer part of the queue for that node and hence it cannot be
1288 ASSERT (!(f->frame_flags & VLIB_FRAME_FREE_AFTER_DISPATCH));
1291 * NB: dispatching node n can result in the creation and scheduling
1292 * of new frames, and hence in the reallocation of nm->pending_frames.
1293 * Recompute p, or no supper. This was broken for more than 10 years.
1295 p = nm->pending_frames + pending_frame_index;
1298 * p->next_frame_index can change during node dispatch if node
1299 * function decides to change graph hook up.
1301 nf = vec_elt_at_index (nm->next_frames, p->next_frame_index);
1302 nf->flags |= VLIB_FRAME_IS_ALLOCATED;
1304 if (~0 == nf->frame_index)
1306 /* no new frame has been assigned to this node, use the saved one */
1307 nf->frame_index = restore_frame_index;
1312 /* The node has gained a frame, implying packets from the current frame
1313 were re-queued to this same node. we don't need the saved one
1315 vlib_frame_free (vm, n, f);
1320 if (f->frame_flags & VLIB_FRAME_FREE_AFTER_DISPATCH)
1322 ASSERT (!(n->flags & VLIB_NODE_FLAG_FRAME_NO_FREE_AFTER_DISPATCH));
1323 vlib_frame_free (vm, n, f);
1327 return last_time_stamp;
1331 vlib_process_stack_is_valid (vlib_process_t * p)
1333 return p->stack[0] == VLIB_PROCESS_STACK_MAGIC;
1339 vlib_process_t *process;
1340 vlib_frame_t *frame;
1341 } vlib_process_bootstrap_args_t;
1343 /* Called in process stack. */
1345 vlib_process_bootstrap (uword _a)
1347 vlib_process_bootstrap_args_t *a;
1349 vlib_node_runtime_t *node;
1354 a = uword_to_pointer (_a, vlib_process_bootstrap_args_t *);
1359 node = &p->node_runtime;
1361 n = node->function (vm, node, f);
1363 ASSERT (vlib_process_stack_is_valid (p));
1365 clib_longjmp (&p->return_longjmp, n);
1370 /* Called in main stack. */
1371 static_always_inline uword
1372 vlib_process_startup (vlib_main_t * vm, vlib_process_t * p, vlib_frame_t * f)
1374 vlib_process_bootstrap_args_t a;
1381 r = clib_setjmp (&p->return_longjmp, VLIB_PROCESS_RETURN_LONGJMP_RETURN);
1382 if (r == VLIB_PROCESS_RETURN_LONGJMP_RETURN)
1383 r = clib_calljmp (vlib_process_bootstrap, pointer_to_uword (&a),
1384 (void *) p->stack + (1 << p->log2_n_stack_bytes));
1389 static_always_inline uword
1390 vlib_process_resume (vlib_process_t * p)
1393 p->flags &= ~(VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_CLOCK
1394 | VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_EVENT
1395 | VLIB_PROCESS_RESUME_PENDING);
1396 r = clib_setjmp (&p->return_longjmp, VLIB_PROCESS_RETURN_LONGJMP_RETURN);
1397 if (r == VLIB_PROCESS_RETURN_LONGJMP_RETURN)
1398 clib_longjmp (&p->resume_longjmp, VLIB_PROCESS_RESUME_LONGJMP_RESUME);
1403 dispatch_process (vlib_main_t * vm,
1404 vlib_process_t * p, vlib_frame_t * f, u64 last_time_stamp)
1406 vlib_node_main_t *nm = &vm->node_main;
1407 vlib_node_runtime_t *node_runtime = &p->node_runtime;
1408 vlib_node_t *node = vlib_get_node (vm, node_runtime->node_index);
1409 u32 old_process_index;
1411 uword n_vectors, is_suspend;
1413 if (node->state != VLIB_NODE_STATE_POLLING
1414 || (p->flags & (VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_CLOCK
1415 | VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_EVENT)))
1416 return last_time_stamp;
1418 p->flags |= VLIB_PROCESS_IS_RUNNING;
1420 t = last_time_stamp;
1421 vlib_elog_main_loop_event (vm, node_runtime->node_index, t,
1422 f ? f->n_vectors : 0, /* is_after */ 0);
1424 /* Save away current process for suspend. */
1425 old_process_index = nm->current_process_index;
1426 nm->current_process_index = node->runtime_index;
1428 n_vectors = vlib_process_startup (vm, p, f);
1430 nm->current_process_index = old_process_index;
1432 ASSERT (n_vectors != VLIB_PROCESS_RETURN_LONGJMP_RETURN);
1433 is_suspend = n_vectors == VLIB_PROCESS_RETURN_LONGJMP_SUSPEND;
1436 vlib_pending_frame_t *pf;
1439 pool_get (nm->suspended_process_frames, pf);
1440 pf->node_runtime_index = node->runtime_index;
1441 pf->frame_index = f ? vlib_frame_index (vm, f) : ~0;
1442 pf->next_frame_index = ~0;
1445 p->suspended_process_frame_index = pf - nm->suspended_process_frames;
1447 if (p->flags & VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_CLOCK)
1449 TWT (tw_timer_wheel) * tw =
1450 (TWT (tw_timer_wheel) *) nm->timing_wheel;
1451 p->stop_timer_handle =
1452 TW (tw_timer_start) (tw,
1453 vlib_timing_wheel_data_set_suspended_process
1454 (node->runtime_index) /* [sic] pool idex */ ,
1456 p->resume_clock_interval);
1460 p->flags &= ~VLIB_PROCESS_IS_RUNNING;
1462 t = clib_cpu_time_now ();
1464 vlib_elog_main_loop_event (vm, node_runtime->node_index, t, is_suspend,
1467 vlib_process_update_stats (vm, p,
1468 /* n_calls */ !is_suspend,
1469 /* n_vectors */ n_vectors,
1470 /* n_clocks */ t - last_time_stamp,
1471 /* pmc_ticks */ 0ULL);
1477 vlib_start_process (vlib_main_t * vm, uword process_index)
1479 vlib_node_main_t *nm = &vm->node_main;
1480 vlib_process_t *p = vec_elt (nm->processes, process_index);
1481 dispatch_process (vm, p, /* frame */ 0, /* cpu_time_now */ 0);
1485 dispatch_suspended_process (vlib_main_t * vm,
1486 uword process_index, u64 last_time_stamp)
1488 vlib_node_main_t *nm = &vm->node_main;
1489 vlib_node_runtime_t *node_runtime;
1493 vlib_pending_frame_t *pf;
1494 u64 t, n_vectors, is_suspend;
1496 t = last_time_stamp;
1498 p = vec_elt (nm->processes, process_index);
1499 if (PREDICT_FALSE (!(p->flags & VLIB_PROCESS_IS_RUNNING)))
1500 return last_time_stamp;
1502 ASSERT (p->flags & (VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_CLOCK
1503 | VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_EVENT));
1505 pf = pool_elt_at_index (nm->suspended_process_frames,
1506 p->suspended_process_frame_index);
1508 node_runtime = &p->node_runtime;
1509 node = vlib_get_node (vm, node_runtime->node_index);
1510 f = pf->frame_index != ~0 ? vlib_get_frame (vm, pf->frame_index) : 0;
1512 vlib_elog_main_loop_event (vm, node_runtime->node_index, t,
1513 f ? f->n_vectors : 0, /* is_after */ 0);
1515 /* Save away current process for suspend. */
1516 nm->current_process_index = node->runtime_index;
1518 n_vectors = vlib_process_resume (p);
1519 t = clib_cpu_time_now ();
1521 nm->current_process_index = ~0;
1523 is_suspend = n_vectors == VLIB_PROCESS_RETURN_LONGJMP_SUSPEND;
1526 /* Suspend it again. */
1529 if (p->flags & VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_CLOCK)
1531 p->stop_timer_handle =
1532 TW (tw_timer_start) ((TWT (tw_timer_wheel) *) nm->timing_wheel,
1533 vlib_timing_wheel_data_set_suspended_process
1534 (node->runtime_index) /* [sic] pool idex */ ,
1536 p->resume_clock_interval);
1541 p->flags &= ~VLIB_PROCESS_IS_RUNNING;
1542 pool_put_index (nm->suspended_process_frames,
1543 p->suspended_process_frame_index);
1544 p->suspended_process_frame_index = ~0;
1547 t = clib_cpu_time_now ();
1548 vlib_elog_main_loop_event (vm, node_runtime->node_index, t, !is_suspend,
1551 vlib_process_update_stats (vm, p,
1552 /* n_calls */ !is_suspend,
1553 /* n_vectors */ n_vectors,
1554 /* n_clocks */ t - last_time_stamp,
1555 /* pmc_ticks */ 0ULL);
1560 void vl_api_send_pending_rpc_requests (vlib_main_t *) __attribute__ ((weak));
1562 vl_api_send_pending_rpc_requests (vlib_main_t * vm)
1567 static_always_inline void
1568 vlib_main_or_worker_loop (vlib_main_t * vm, int is_main)
1570 vlib_node_main_t *nm = &vm->node_main;
1571 vlib_thread_main_t *tm = vlib_get_thread_main ();
1574 vlib_frame_queue_main_t *fqm;
1575 u32 *last_node_runtime_indices = 0;
1577 /* Initialize pending node vector. */
1580 vec_resize (nm->pending_frames, 32);
1581 _vec_len (nm->pending_frames) = 0;
1584 /* Mark time of main loop start. */
1587 cpu_time_now = vm->clib_time.last_cpu_time;
1588 vm->cpu_time_main_loop_start = cpu_time_now;
1591 cpu_time_now = clib_cpu_time_now ();
1593 /* Pre-allocate interupt runtime indices and lock. */
1594 vec_alloc (nm->pending_interrupt_node_runtime_indices, 32);
1595 vec_alloc (last_node_runtime_indices, 32);
1597 clib_spinlock_init (&nm->pending_interrupt_lock);
1599 /* Pre-allocate expired nodes. */
1600 if (!nm->polling_threshold_vector_length)
1601 nm->polling_threshold_vector_length = 10;
1602 if (!nm->interrupt_threshold_vector_length)
1603 nm->interrupt_threshold_vector_length = 5;
1605 /* Make sure the performance monitor counter is disabled */
1606 vm->perf_counter_id = ~0;
1608 /* Start all processes. */
1612 nm->current_process_index = ~0;
1613 for (i = 0; i < vec_len (nm->processes); i++)
1614 cpu_time_now = dispatch_process (vm, nm->processes[i], /* frame */ 0,
1620 vlib_node_runtime_t *n;
1622 if (PREDICT_FALSE (_vec_len (vm->pending_rpc_requests) > 0))
1625 vl_api_send_pending_rpc_requests (vm);
1630 vlib_worker_thread_barrier_check ();
1631 vec_foreach (fqm, tm->frame_queue_mains)
1632 vlib_frame_queue_dequeue (vm, fqm);
1633 if (PREDICT_FALSE (vm->worker_thread_main_loop_callback != 0))
1634 ((void (*)(vlib_main_t *)) vm->worker_thread_main_loop_callback)
1638 /* Process pre-input nodes. */
1639 vec_foreach (n, nm->nodes_by_type[VLIB_NODE_TYPE_PRE_INPUT])
1640 cpu_time_now = dispatch_node (vm, n,
1641 VLIB_NODE_TYPE_PRE_INPUT,
1642 VLIB_NODE_STATE_POLLING,
1646 /* Next process input nodes. */
1647 vec_foreach (n, nm->nodes_by_type[VLIB_NODE_TYPE_INPUT])
1648 cpu_time_now = dispatch_node (vm, n,
1649 VLIB_NODE_TYPE_INPUT,
1650 VLIB_NODE_STATE_POLLING,
1654 if (PREDICT_TRUE (is_main && vm->queue_signal_pending == 0))
1655 vm->queue_signal_callback (vm);
1657 /* Next handle interrupts. */
1659 /* unlocked read, for performance */
1660 uword l = _vec_len (nm->pending_interrupt_node_runtime_indices);
1662 if (PREDICT_FALSE (l > 0))
1667 clib_spinlock_lock (&nm->pending_interrupt_lock);
1668 /* Re-read w/ lock held, in case another thread added an item */
1669 l = _vec_len (nm->pending_interrupt_node_runtime_indices);
1672 tmp = nm->pending_interrupt_node_runtime_indices;
1673 nm->pending_interrupt_node_runtime_indices =
1674 last_node_runtime_indices;
1675 last_node_runtime_indices = tmp;
1676 _vec_len (last_node_runtime_indices) = 0;
1678 clib_spinlock_unlock (&nm->pending_interrupt_lock);
1679 for (i = 0; i < l; i++)
1681 n = vec_elt_at_index (nm->nodes_by_type[VLIB_NODE_TYPE_INPUT],
1682 last_node_runtime_indices[i]);
1684 dispatch_node (vm, n, VLIB_NODE_TYPE_INPUT,
1685 VLIB_NODE_STATE_INTERRUPT,
1691 /* Input nodes may have added work to the pending vector.
1692 Process pending vector until there is nothing left.
1693 All pending vectors will be processed from input -> output. */
1694 for (i = 0; i < _vec_len (nm->pending_frames); i++)
1695 cpu_time_now = dispatch_pending_node (vm, i, cpu_time_now);
1696 /* Reset pending vector for next iteration. */
1697 _vec_len (nm->pending_frames) = 0;
1701 /* Check if process nodes have expired from timing wheel. */
1702 ASSERT (nm->data_from_advancing_timing_wheel != 0);
1704 nm->data_from_advancing_timing_wheel =
1705 TW (tw_timer_expire_timers_vec)
1706 ((TWT (tw_timer_wheel) *) nm->timing_wheel, vlib_time_now (vm),
1707 nm->data_from_advancing_timing_wheel);
1709 ASSERT (nm->data_from_advancing_timing_wheel != 0);
1712 (_vec_len (nm->data_from_advancing_timing_wheel) > 0))
1716 for (i = 0; i < _vec_len (nm->data_from_advancing_timing_wheel);
1719 u32 d = nm->data_from_advancing_timing_wheel[i];
1720 u32 di = vlib_timing_wheel_data_get_index (d);
1722 if (vlib_timing_wheel_data_is_timed_event (d))
1724 vlib_signal_timed_event_data_t *te =
1725 pool_elt_at_index (nm->signal_timed_event_data_pool,
1728 vlib_get_node (vm, te->process_node_index);
1730 vec_elt (nm->processes, n->runtime_index);
1733 vlib_process_signal_event_helper (nm, n, p,
1734 te->event_type_index,
1736 te->n_data_elt_bytes);
1737 if (te->n_data_bytes < sizeof (te->inline_event_data))
1738 clib_memcpy_fast (data, te->inline_event_data,
1742 clib_memcpy_fast (data, te->event_data_as_vector,
1744 vec_free (te->event_data_as_vector);
1746 pool_put (nm->signal_timed_event_data_pool, te);
1750 cpu_time_now = clib_cpu_time_now ();
1752 dispatch_suspended_process (vm, di, cpu_time_now);
1755 _vec_len (nm->data_from_advancing_timing_wheel) = 0;
1758 vlib_increment_main_loop_counter (vm);
1760 /* Record time stamp in case there are no enabled nodes and above
1761 calls do not update time stamp. */
1762 cpu_time_now = clib_cpu_time_now ();
1767 vlib_main_loop (vlib_main_t * vm)
1769 vlib_main_or_worker_loop (vm, /* is_main */ 1);
1773 vlib_worker_loop (vlib_main_t * vm)
1775 vlib_main_or_worker_loop (vm, /* is_main */ 0);
1778 vlib_main_t vlib_global_main;
1780 static clib_error_t *
1781 vlib_main_configure (vlib_main_t * vm, unformat_input_t * input)
1783 int turn_on_mem_trace = 0;
1785 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
1787 if (unformat (input, "memory-trace"))
1788 turn_on_mem_trace = 1;
1790 else if (unformat (input, "elog-events %d",
1791 &vm->elog_main.event_ring_size))
1793 else if (unformat (input, "elog-post-mortem-dump"))
1794 vm->elog_post_mortem_dump = 1;
1796 return unformat_parse_error (input);
1799 unformat_free (input);
1801 /* Enable memory trace as early as possible. */
1802 if (turn_on_mem_trace)
1808 VLIB_EARLY_CONFIG_FUNCTION (vlib_main_configure, "vlib");
1811 dummy_queue_signal_callback (vlib_main_t * vm)
1815 #define foreach_weak_reference_stub \
1816 _(vlib_map_stat_segment_init) \
1818 _(vlibmemory_init) \
1819 _(map_api_segment_init)
1822 clib_error_t *name (vlib_main_t *vm) __attribute__((weak)); \
1823 clib_error_t *name (vlib_main_t *vm) { return 0; }
1824 foreach_weak_reference_stub;
1827 /* Main function. */
1829 vlib_main (vlib_main_t * volatile vm, unformat_input_t * input)
1831 clib_error_t *volatile error;
1832 vlib_node_main_t *nm = &vm->node_main;
1834 vm->queue_signal_callback = dummy_queue_signal_callback;
1836 clib_time_init (&vm->clib_time);
1838 /* Turn on event log. */
1839 if (!vm->elog_main.event_ring_size)
1840 vm->elog_main.event_ring_size = 128 << 10;
1841 elog_init (&vm->elog_main, vm->elog_main.event_ring_size);
1842 elog_enable_disable (&vm->elog_main, 1);
1848 if ((error = vlib_physmem_init (vm)))
1850 clib_error_report (error);
1854 if ((error = vlib_buffer_main_init (vm)))
1856 clib_error_report (error);
1860 if ((error = vlib_thread_init (vm)))
1862 clib_error_report (error);
1866 if ((error = vlib_map_stat_segment_init (vm)))
1868 clib_error_report (error);
1872 /* Register static nodes so that init functions may use them. */
1873 vlib_register_all_static_nodes (vm);
1875 /* Set seed for random number generator.
1876 Allow user to specify seed to make random sequence deterministic. */
1877 if (!unformat (input, "seed %wd", &vm->random_seed))
1878 vm->random_seed = clib_cpu_time_now ();
1879 clib_random_buffer_init (&vm->random_buffer, vm->random_seed);
1881 /* Initialize node graph. */
1882 if ((error = vlib_node_main_init (vm)))
1884 /* Arrange for graph hook up error to not be fatal when debugging. */
1886 clib_error_report (error);
1891 /* Direct call / weak reference, for vlib standalone use-cases */
1892 if ((error = vpe_api_init (vm)))
1894 clib_error_report (error);
1898 if ((error = vlibmemory_init (vm)))
1900 clib_error_report (error);
1904 if ((error = map_api_segment_init (vm)))
1906 clib_error_report (error);
1910 /* See unix/main.c; most likely already set up */
1911 if (vm->init_functions_called == 0)
1912 vm->init_functions_called = hash_create (0, /* value bytes */ 0);
1913 if ((error = vlib_call_all_init_functions (vm)))
1916 /* Create default buffer free list. */
1917 vlib_buffer_create_free_list (vm, VLIB_BUFFER_DEFAULT_FREE_LIST_BYTES,
1920 nm->timing_wheel = clib_mem_alloc_aligned (sizeof (TWT (tw_timer_wheel)),
1921 CLIB_CACHE_LINE_BYTES);
1923 vec_validate (nm->data_from_advancing_timing_wheel, 10);
1924 _vec_len (nm->data_from_advancing_timing_wheel) = 0;
1926 /* Create the process timing wheel */
1927 TW (tw_timer_wheel_init) ((TWT (tw_timer_wheel) *) nm->timing_wheel,
1928 0 /* no callback */ ,
1929 10e-6 /* timer period 10us */ ,
1930 ~0 /* max expirations per call */ );
1932 vec_validate (vm->pending_rpc_requests, 0);
1933 _vec_len (vm->pending_rpc_requests) = 0;
1934 vec_validate (vm->processing_rpc_requests, 0);
1935 _vec_len (vm->processing_rpc_requests) = 0;
1937 switch (clib_setjmp (&vm->main_loop_exit, VLIB_MAIN_LOOP_EXIT_NONE))
1939 case VLIB_MAIN_LOOP_EXIT_NONE:
1940 vm->main_loop_exit_set = 1;
1943 case VLIB_MAIN_LOOP_EXIT_CLI:
1947 error = vm->main_loop_error;
1951 if ((error = vlib_call_all_config_functions (vm, input, 0 /* is_early */ )))
1954 /* Call all main loop enter functions. */
1956 clib_error_t *sub_error;
1957 sub_error = vlib_call_all_main_loop_enter_functions (vm);
1959 clib_error_report (sub_error);
1962 vlib_main_loop (vm);
1965 /* Call all exit functions. */
1967 clib_error_t *sub_error;
1968 sub_error = vlib_call_all_main_loop_exit_functions (vm);
1970 clib_error_report (sub_error);
1974 clib_error_report (error);
1979 static inline clib_error_t *
1980 pcap_dispatch_trace_command_internal (vlib_main_t * vm,
1981 unformat_input_t * input,
1982 vlib_cli_command_t * cmd, int rx_tx)
1984 #define PCAP_DEF_PKT_TO_CAPTURE (100)
1986 unformat_input_t _line_input, *line_input = &_line_input;
1987 pcap_main_t *pm = &vm->dispatch_pcap_main;
1989 u8 *chroot_filename = 0;
1993 clib_error_t *error = 0;
1995 /* Get a line of input. */
1996 if (!unformat_user (input, unformat_line_input, line_input))
1999 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
2001 if (unformat (line_input, "on"))
2003 if (vm->dispatch_pcap_enable == 0)
2009 vlib_cli_output (vm, "pcap dispatch capture already on...");
2014 else if (unformat (line_input, "off"))
2016 if (vm->dispatch_pcap_enable)
2019 (vm, "captured %d pkts...", pm->n_packets_captured);
2020 if (pm->n_packets_captured)
2022 pm->n_packets_to_capture = pm->n_packets_captured;
2023 error = pcap_write (pm);
2025 clib_error_report (error);
2027 vlib_cli_output (vm, "saved to %s...", pm->file_name);
2029 vm->dispatch_pcap_enable = 0;
2033 vlib_cli_output (vm, "pcap tx capture already off...");
2038 else if (unformat (line_input, "max %d", &max))
2040 if (vm->dispatch_pcap_enable)
2044 "can't change max value while pcap tx capture active...");
2048 pm->n_packets_to_capture = max;
2050 else if (unformat (line_input, "file %s", &filename))
2052 if (vm->dispatch_pcap_enable)
2055 (vm, "can't change file while pcap tx capture active...");
2060 /* Brain-police user path input */
2061 if (strstr ((char *) filename, "..")
2062 || index ((char *) filename, '/'))
2064 vlib_cli_output (vm, "illegal characters in filename '%s'",
2066 vlib_cli_output (vm, "Hint: .. and / are not allowed.");
2067 vec_free (filename);
2072 chroot_filename = format (0, "/tmp/%s%c", filename, 0);
2073 vec_free (filename);
2075 else if (unformat (line_input, "status"))
2077 if (vm->dispatch_pcap_enable)
2080 (vm, "pcap dispatch capture is on: %d of %d pkts...",
2081 pm->n_packets_captured, pm->n_packets_to_capture);
2082 vlib_cli_output (vm, "Capture to file %s", pm->file_name);
2086 vlib_cli_output (vm, "pcap dispatch capture is off...");
2093 error = clib_error_return (0, "unknown input `%U'",
2094 format_unformat_error, line_input);
2099 unformat_free (line_input);
2104 /* Since no error, save configured values. */
2105 if (chroot_filename)
2108 vec_free (pm->file_name);
2109 vec_add1 (chroot_filename, 0);
2110 pm->file_name = (char *) chroot_filename;
2114 pm->n_packets_to_capture = max;
2118 if (pm->file_name == 0)
2119 pm->file_name = (char *) format (0, "/tmp/dispatch.pcap%c", 0);
2121 pm->n_packets_captured = 0;
2122 pm->packet_type = PCAP_PACKET_TYPE_user13;
2124 clib_spinlock_init (&(pm->lock));
2125 vm->dispatch_pcap_enable = 1;
2126 vlib_cli_output (vm, "pcap dispatch capture on...");
2129 else if (chroot_filename)
2130 vec_free (chroot_filename);
2135 static clib_error_t *
2136 pcap_dispatch_trace_command_fn (vlib_main_t * vm,
2137 unformat_input_t * input,
2138 vlib_cli_command_t * cmd)
2140 return pcap_dispatch_trace_command_internal (vm, input, cmd, VLIB_RX);
2144 * This command is used to start or stop pcap dispatch trace capture, or show
2145 * the capture status.
2147 * This command has the following optional parameters:
2149 * - <b>on|off</b> - Used to start or stop capture.
2151 * - <b>max <nn></b> - Depth of local buffer. Once '<em>nn</em>' number
2152 * of packets have been received, buffer is flushed to file. Once another
2153 * '<em>nn</em>' number of packets have been received, buffer is flushed
2154 * to file, overwriting previous write. If not entered, value defaults
2155 * to 100. Can only be updated if packet capture is off.
2157 * - <b>file <name></b> - Used to specify the output filename. The file will
2158 * be placed in the '<em>/tmp</em>' directory, so only the filename is
2159 * supported. Directory should not be entered. If file already exists, file
2160 * will be overwritten. If no filename is provided, '<em>/tmp/vpe.pcap</em>'
2161 * will be used. Can only be updated if packet capture is off.
2163 * - <b>status</b> - Displays the current status and configured attributes
2164 * associated with a packet capture. If packet capture is in progress,
2165 * '<em>status</em>' also will return the number of packets currently in
2166 * the local buffer. All additional attributes entered on command line
2167 * with '<em>status</em>' will be ignored and not applied.
2170 * Example of how to display the status of capture when off:
2171 * @cliexstart{pcap dispatch trace status}
2172 * max is 100, for any interface to file /tmp/vpe.pcap
2173 * pcap dispatch capture is off...
2175 * Example of how to start a dispatch trace capture:
2176 * @cliexstart{pcap dispatch trace on max 35 file dispatchTrace.pcap}
2177 * pcap dispatc capture on...
2179 * Example of how to display the status of a tx packet capture in progress:
2180 * @cliexstart{pcap tx trace status}
2181 * max is 35, dispatch trace to file /tmp/vppTest.pcap
2182 * pcap tx capture is on: 20 of 35 pkts...
2184 * Example of how to stop a tx packet capture:
2185 * @cliexstart{vppctl pcap dispatch trace off}
2186 * captured 21 pkts...
2187 * saved to /tmp/dispatchTrace.pcap...
2191 VLIB_CLI_COMMAND (pcap_dispatch_trace_command, static) = {
2192 .path = "pcap dispatch trace",
2194 "pcap dispatch trace [on|off] [max <nn>] [file <name>] [status]",
2195 .function = pcap_dispatch_trace_command_fn,
2200 * fd.io coding-style-patch-verification: ON
2203 * eval: (c-set-style "gnu")