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>
48 /* Actually allocate a few extra slots of vector data to support
49 speculative vector enqueues which overflow vector data in next frame. */
50 #define VLIB_FRAME_SIZE_ALLOC (VLIB_FRAME_SIZE + 4)
53 vlib_frame_bytes (u32 n_scalar_bytes, u32 n_vector_bytes)
57 /* Make room for vlib_frame_t plus scalar arguments. */
58 n_bytes = vlib_frame_vector_byte_offset (n_scalar_bytes);
60 /* Make room for vector arguments.
61 Allocate a few extra slots of vector data to support
62 speculative vector enqueues which overflow vector data in next frame. */
63 #define VLIB_FRAME_SIZE_EXTRA 4
64 n_bytes += (VLIB_FRAME_SIZE + VLIB_FRAME_SIZE_EXTRA) * n_vector_bytes;
66 /* Magic number is first 32bit number after vector data.
67 Used to make sure that vector data is never overrun. */
68 #define VLIB_FRAME_MAGIC (0xabadc0ed)
69 n_bytes += sizeof (u32);
71 /* Pad to cache line. */
72 n_bytes = round_pow2 (n_bytes, CLIB_CACHE_LINE_BYTES);
78 vlib_frame_find_magic (vlib_frame_t * f, vlib_node_t * node)
82 p += vlib_frame_vector_byte_offset (node->scalar_size);
84 p += (VLIB_FRAME_SIZE + VLIB_FRAME_SIZE_EXTRA) * node->vector_size;
89 static inline vlib_frame_size_t *
90 get_frame_size_info (vlib_node_main_t * nm,
91 u32 n_scalar_bytes, u32 n_vector_bytes)
93 #ifdef VLIB_SUPPORTS_ARBITRARY_SCALAR_SIZES
94 uword key = (n_scalar_bytes << 16) | n_vector_bytes;
97 p = hash_get (nm->frame_size_hash, key);
102 i = vec_len (nm->frame_sizes);
103 vec_validate (nm->frame_sizes, i);
104 hash_set (nm->frame_size_hash, key, i);
107 return vec_elt_at_index (nm->frame_sizes, i);
109 ASSERT (vlib_frame_bytes (n_scalar_bytes, n_vector_bytes)
110 == (vlib_frame_bytes (0, 4)));
111 return vec_elt_at_index (nm->frame_sizes, 0);
115 static vlib_frame_t *
116 vlib_frame_alloc_to_node (vlib_main_t * vm, u32 to_node_index,
119 vlib_node_main_t *nm = &vm->node_main;
120 vlib_frame_size_t *fs;
121 vlib_node_t *to_node;
123 u32 l, n, scalar_size, vector_size;
125 to_node = vlib_get_node (vm, to_node_index);
127 scalar_size = to_node->scalar_size;
128 vector_size = to_node->vector_size;
130 fs = get_frame_size_info (nm, scalar_size, vector_size);
131 n = vlib_frame_bytes (scalar_size, vector_size);
132 if ((l = vec_len (fs->free_frames)) > 0)
134 /* Allocate from end of free list. */
135 f = fs->free_frames[l - 1];
136 _vec_len (fs->free_frames) = l - 1;
140 f = clib_mem_alloc_aligned_no_fail (n, VLIB_FRAME_ALIGN);
143 /* Poison frame when debugging. */
145 clib_memset (f, 0xfe, n);
147 /* Insert magic number. */
151 magic = vlib_frame_find_magic (f, to_node);
152 *magic = VLIB_FRAME_MAGIC;
155 f->frame_flags = VLIB_FRAME_IS_ALLOCATED | frame_flags;
157 f->scalar_size = scalar_size;
158 f->vector_size = vector_size;
161 fs->n_alloc_frames += 1;
166 /* Allocate a frame for from FROM_NODE to TO_NODE via TO_NEXT_INDEX.
167 Returns frame index. */
168 static vlib_frame_t *
169 vlib_frame_alloc (vlib_main_t * vm, vlib_node_runtime_t * from_node_runtime,
172 vlib_node_t *from_node;
174 from_node = vlib_get_node (vm, from_node_runtime->node_index);
175 ASSERT (to_next_index < vec_len (from_node->next_nodes));
177 return vlib_frame_alloc_to_node (vm, from_node->next_nodes[to_next_index],
178 /* frame_flags */ 0);
182 vlib_get_frame_to_node (vlib_main_t * vm, u32 to_node_index)
184 vlib_frame_t *f = vlib_frame_alloc_to_node (vm, to_node_index,
186 VLIB_FRAME_FREE_AFTER_DISPATCH);
187 return vlib_get_frame (vm, f);
191 vlib_validate_frame_indices (vlib_frame_t * f)
196 u32 *from = vlib_frame_vector_args (f);
198 /* Check for bad buffer index values */
199 for (i = 0; i < f->n_vectors; i++)
203 clib_warning ("BUG: buffer index 0 at index %d", i);
206 else if (from[i] == 0xfefefefe)
208 clib_warning ("BUG: frame poison pattern at index %d", i);
216 vlib_put_frame_to_node (vlib_main_t * vm, u32 to_node_index, vlib_frame_t * f)
218 vlib_pending_frame_t *p;
219 vlib_node_t *to_node;
221 if (f->n_vectors == 0)
224 vlib_validate_frame_indices (f);
226 to_node = vlib_get_node (vm, to_node_index);
228 vec_add2 (vm->node_main.pending_frames, p, 1);
230 f->frame_flags |= VLIB_FRAME_PENDING;
231 p->frame = vlib_get_frame (vm, f);
232 p->node_runtime_index = to_node->runtime_index;
233 p->next_frame_index = VLIB_PENDING_FRAME_NO_NEXT_FRAME;
236 /* Free given frame. */
238 vlib_frame_free (vlib_main_t * vm, vlib_node_runtime_t * r, vlib_frame_t * f)
240 vlib_node_main_t *nm = &vm->node_main;
242 vlib_frame_size_t *fs;
244 ASSERT (f->frame_flags & VLIB_FRAME_IS_ALLOCATED);
246 node = vlib_get_node (vm, r->node_index);
247 fs = get_frame_size_info (nm, node->scalar_size, node->vector_size);
249 ASSERT (f->frame_flags & VLIB_FRAME_IS_ALLOCATED);
251 /* No next frames may point to freed frame. */
254 vlib_next_frame_t *nf;
255 vec_foreach (nf, vm->node_main.next_frames) ASSERT (nf->frame != f);
258 f->frame_flags &= ~(VLIB_FRAME_IS_ALLOCATED | VLIB_FRAME_NO_APPEND);
260 vec_add1 (fs->free_frames, f);
261 ASSERT (fs->n_alloc_frames > 0);
262 fs->n_alloc_frames -= 1;
265 static clib_error_t *
266 show_frame_stats (vlib_main_t * vm,
267 unformat_input_t * input, vlib_cli_command_t * cmd)
269 vlib_node_main_t *nm = &vm->node_main;
270 vlib_frame_size_t *fs;
272 vlib_cli_output (vm, "%=6s%=12s%=12s", "Size", "# Alloc", "# Free");
273 vec_foreach (fs, nm->frame_sizes)
275 u32 n_alloc = fs->n_alloc_frames;
276 u32 n_free = vec_len (fs->free_frames);
278 if (n_alloc + n_free > 0)
279 vlib_cli_output (vm, "%=6d%=12d%=12d",
280 fs - nm->frame_sizes, n_alloc, n_free);
287 VLIB_CLI_COMMAND (show_frame_stats_cli, static) = {
288 .path = "show vlib frame-allocation",
289 .short_help = "Show node dispatch frame statistics",
290 .function = show_frame_stats,
294 /* Change ownership of enqueue rights to given next node. */
296 vlib_next_frame_change_ownership (vlib_main_t * vm,
297 vlib_node_runtime_t * node_runtime,
300 vlib_node_main_t *nm = &vm->node_main;
301 vlib_next_frame_t *next_frame;
302 vlib_node_t *node, *next_node;
304 node = vec_elt (nm->nodes, node_runtime->node_index);
306 /* Only internal & input nodes are allowed to call other nodes. */
307 ASSERT (node->type == VLIB_NODE_TYPE_INTERNAL
308 || node->type == VLIB_NODE_TYPE_INPUT
309 || node->type == VLIB_NODE_TYPE_PROCESS);
311 ASSERT (vec_len (node->next_nodes) == node_runtime->n_next_nodes);
314 vlib_node_runtime_get_next_frame (vm, node_runtime, next_index);
315 next_node = vec_elt (nm->nodes, node->next_nodes[next_index]);
317 if (next_node->owner_node_index != VLIB_INVALID_NODE_INDEX)
319 /* Get frame from previous owner. */
320 vlib_next_frame_t *owner_next_frame;
321 vlib_next_frame_t tmp;
324 vlib_node_get_next_frame (vm,
325 next_node->owner_node_index,
326 next_node->owner_next_index);
328 /* Swap target next frame with owner's. */
329 tmp = owner_next_frame[0];
330 owner_next_frame[0] = next_frame[0];
334 * If next_frame is already pending, we have to track down
335 * all pending frames and fix their next_frame_index fields.
337 if (next_frame->flags & VLIB_FRAME_PENDING)
339 vlib_pending_frame_t *p;
340 if (next_frame->frame != NULL)
342 vec_foreach (p, nm->pending_frames)
344 if (p->frame == next_frame->frame)
346 p->next_frame_index =
347 next_frame - vm->node_main.next_frames;
355 /* No previous owner. Take ownership. */
356 next_frame->flags |= VLIB_FRAME_OWNER;
359 /* Record new owner. */
360 next_node->owner_node_index = node->index;
361 next_node->owner_next_index = next_index;
363 /* Now we should be owner. */
364 ASSERT (next_frame->flags & VLIB_FRAME_OWNER);
367 /* Make sure that magic number is still there.
368 Otherwise, it is likely that caller has overrun frame arguments. */
370 validate_frame_magic (vlib_main_t * vm,
371 vlib_frame_t * f, vlib_node_t * n, uword next_index)
373 vlib_node_t *next_node = vlib_get_node (vm, n->next_nodes[next_index]);
374 u32 *magic = vlib_frame_find_magic (f, next_node);
375 ASSERT (VLIB_FRAME_MAGIC == magic[0]);
379 vlib_get_next_frame_internal (vlib_main_t * vm,
380 vlib_node_runtime_t * node,
381 u32 next_index, u32 allocate_new_next_frame)
384 vlib_next_frame_t *nf;
387 nf = vlib_node_runtime_get_next_frame (vm, node, next_index);
389 /* Make sure this next frame owns right to enqueue to destination frame. */
390 if (PREDICT_FALSE (!(nf->flags & VLIB_FRAME_OWNER)))
391 vlib_next_frame_change_ownership (vm, node, next_index);
393 /* ??? Don't need valid flag: can use frame_index == ~0 */
394 if (PREDICT_FALSE (!(nf->flags & VLIB_FRAME_IS_ALLOCATED)))
396 nf->frame = vlib_frame_alloc (vm, node, next_index);
397 nf->flags |= VLIB_FRAME_IS_ALLOCATED;
402 /* Has frame been removed from pending vector (e.g. finished dispatching)?
403 If so we can reuse frame. */
404 if ((nf->flags & VLIB_FRAME_PENDING)
405 && !(f->frame_flags & VLIB_FRAME_PENDING))
407 nf->flags &= ~VLIB_FRAME_PENDING;
412 /* Allocate new frame if current one is marked as no-append or
413 it is already full. */
414 n_used = f->n_vectors;
415 if (n_used >= VLIB_FRAME_SIZE || (allocate_new_next_frame && n_used > 0) ||
416 (f->frame_flags & VLIB_FRAME_NO_APPEND))
418 /* Old frame may need to be freed after dispatch, since we'll have
419 two redundant frames from node -> next node. */
420 if (!(nf->flags & VLIB_FRAME_NO_FREE_AFTER_DISPATCH))
422 vlib_frame_t *f_old = vlib_get_frame (vm, nf->frame);
423 f_old->frame_flags |= VLIB_FRAME_FREE_AFTER_DISPATCH;
426 /* Allocate new frame to replace full one. */
427 f = nf->frame = vlib_frame_alloc (vm, node, next_index);
428 n_used = f->n_vectors;
431 /* Should have free vectors in frame now. */
432 ASSERT (n_used < VLIB_FRAME_SIZE);
436 validate_frame_magic (vm, f,
437 vlib_get_node (vm, node->node_index), next_index);
444 vlib_put_next_frame_validate (vlib_main_t * vm,
445 vlib_node_runtime_t * rt,
446 u32 next_index, u32 n_vectors_left)
448 vlib_node_main_t *nm = &vm->node_main;
449 vlib_next_frame_t *nf;
451 vlib_node_runtime_t *next_rt;
452 vlib_node_t *next_node;
453 u32 n_before, n_after;
455 nf = vlib_node_runtime_get_next_frame (vm, rt, next_index);
456 f = vlib_get_frame (vm, nf->frame);
458 ASSERT (n_vectors_left <= VLIB_FRAME_SIZE);
460 vlib_validate_frame_indices (f);
462 n_after = VLIB_FRAME_SIZE - n_vectors_left;
463 n_before = f->n_vectors;
465 ASSERT (n_after >= n_before);
467 next_rt = vec_elt_at_index (nm->nodes_by_type[VLIB_NODE_TYPE_INTERNAL],
468 nf->node_runtime_index);
469 next_node = vlib_get_node (vm, next_rt->node_index);
470 if (n_after > 0 && next_node->validate_frame)
472 u8 *msg = next_node->validate_frame (vm, rt, f);
475 clib_warning ("%v", msg);
483 vlib_put_next_frame (vlib_main_t * vm,
484 vlib_node_runtime_t * r,
485 u32 next_index, u32 n_vectors_left)
487 vlib_node_main_t *nm = &vm->node_main;
488 vlib_next_frame_t *nf;
490 u32 n_vectors_in_frame;
493 vlib_put_next_frame_validate (vm, r, next_index, n_vectors_left);
495 nf = vlib_node_runtime_get_next_frame (vm, r, next_index);
496 f = vlib_get_frame (vm, nf->frame);
498 /* Make sure that magic number is still there. Otherwise, caller
499 has overrun frame meta data. */
502 vlib_node_t *node = vlib_get_node (vm, r->node_index);
503 validate_frame_magic (vm, f, node, next_index);
506 /* Convert # of vectors left -> number of vectors there. */
507 ASSERT (n_vectors_left <= VLIB_FRAME_SIZE);
508 n_vectors_in_frame = VLIB_FRAME_SIZE - n_vectors_left;
510 f->n_vectors = n_vectors_in_frame;
512 /* If vectors were added to frame, add to pending vector. */
513 if (PREDICT_TRUE (n_vectors_in_frame > 0))
515 vlib_pending_frame_t *p;
518 r->cached_next_index = next_index;
520 if (!(f->frame_flags & VLIB_FRAME_PENDING))
522 __attribute__ ((unused)) vlib_node_t *node;
523 vlib_node_t *next_node;
524 vlib_node_runtime_t *next_runtime;
526 node = vlib_get_node (vm, r->node_index);
527 next_node = vlib_get_next_node (vm, r->node_index, next_index);
528 next_runtime = vlib_node_get_runtime (vm, next_node->index);
530 vec_add2 (nm->pending_frames, p, 1);
532 p->frame = nf->frame;
533 p->node_runtime_index = nf->node_runtime_index;
534 p->next_frame_index = nf - nm->next_frames;
535 nf->flags |= VLIB_FRAME_PENDING;
536 f->frame_flags |= VLIB_FRAME_PENDING;
539 * If we're going to dispatch this frame on another thread,
540 * force allocation of a new frame. Otherwise, we create
541 * a dangling frame reference. Each thread has its own copy of
542 * the next_frames vector.
544 if (0 && r->thread_index != next_runtime->thread_index)
547 nf->flags &= ~(VLIB_FRAME_PENDING | VLIB_FRAME_IS_ALLOCATED);
551 /* Copy trace flag from next_frame and from runtime. */
553 (nf->flags & VLIB_NODE_FLAG_TRACE) | (r->
554 flags & VLIB_NODE_FLAG_TRACE);
556 v0 = nf->vectors_since_last_overflow;
557 v1 = v0 + n_vectors_in_frame;
558 nf->vectors_since_last_overflow = v1;
559 if (PREDICT_FALSE (v1 < v0))
561 vlib_node_t *node = vlib_get_node (vm, r->node_index);
562 vec_elt (node->n_vectors_by_next_node, next_index) += v0;
567 /* Sync up runtime (32 bit counters) and main node stats (64 bit counters). */
569 vlib_node_runtime_sync_stats (vlib_main_t * vm,
570 vlib_node_runtime_t * r,
571 uword n_calls, uword n_vectors, uword n_clocks)
573 vlib_node_t *n = vlib_get_node (vm, r->node_index);
575 n->stats_total.calls += n_calls + r->calls_since_last_overflow;
576 n->stats_total.vectors += n_vectors + r->vectors_since_last_overflow;
577 n->stats_total.clocks += n_clocks + r->clocks_since_last_overflow;
578 n->stats_total.max_clock = r->max_clock;
579 n->stats_total.max_clock_n = r->max_clock_n;
581 r->calls_since_last_overflow = 0;
582 r->vectors_since_last_overflow = 0;
583 r->clocks_since_last_overflow = 0;
586 always_inline void __attribute__ ((unused))
587 vlib_process_sync_stats (vlib_main_t * vm,
589 uword n_calls, uword n_vectors, uword n_clocks)
591 vlib_node_runtime_t *rt = &p->node_runtime;
592 vlib_node_t *n = vlib_get_node (vm, rt->node_index);
593 vlib_node_runtime_sync_stats (vm, rt, n_calls, n_vectors, n_clocks);
594 n->stats_total.suspends += p->n_suspends;
599 vlib_node_sync_stats (vlib_main_t * vm, vlib_node_t * n)
601 vlib_node_runtime_t *rt;
603 if (n->type == VLIB_NODE_TYPE_PROCESS)
605 /* Nothing to do for PROCESS nodes except in main thread */
606 if (vm != &vlib_global_main)
609 vlib_process_t *p = vlib_get_process_from_node (vm, n);
610 n->stats_total.suspends += p->n_suspends;
612 rt = &p->node_runtime;
616 vec_elt_at_index (vm->node_main.nodes_by_type[n->type],
619 vlib_node_runtime_sync_stats (vm, rt, 0, 0, 0);
621 /* Sync up runtime next frame vector counters with main node structure. */
623 vlib_next_frame_t *nf;
625 for (i = 0; i < rt->n_next_nodes; i++)
627 nf = vlib_node_runtime_get_next_frame (vm, rt, i);
628 vec_elt (n->n_vectors_by_next_node, i) +=
629 nf->vectors_since_last_overflow;
630 nf->vectors_since_last_overflow = 0;
636 vlib_node_runtime_update_stats (vlib_main_t * vm,
637 vlib_node_runtime_t * node,
639 uword n_vectors, uword n_clocks)
641 u32 ca0, ca1, v0, v1, cl0, cl1, r;
643 cl0 = cl1 = node->clocks_since_last_overflow;
644 ca0 = ca1 = node->calls_since_last_overflow;
645 v0 = v1 = node->vectors_since_last_overflow;
649 cl1 = cl0 + n_clocks;
651 node->calls_since_last_overflow = ca1;
652 node->clocks_since_last_overflow = cl1;
653 node->vectors_since_last_overflow = v1;
655 node->max_clock_n = node->max_clock > n_clocks ?
656 node->max_clock_n : n_vectors;
657 node->max_clock = node->max_clock > n_clocks ? node->max_clock : n_clocks;
659 r = vlib_node_runtime_update_main_loop_vector_stats (vm, node, n_vectors);
661 if (PREDICT_FALSE (ca1 < ca0 || v1 < v0 || cl1 < cl0))
663 node->calls_since_last_overflow = ca0;
664 node->clocks_since_last_overflow = cl0;
665 node->vectors_since_last_overflow = v0;
667 vlib_node_runtime_sync_stats (vm, node, n_calls, n_vectors, n_clocks);
674 vlib_process_update_stats (vlib_main_t * vm,
676 uword n_calls, uword n_vectors, uword n_clocks)
678 vlib_node_runtime_update_stats (vm, &p->node_runtime,
679 n_calls, n_vectors, n_clocks);
682 static clib_error_t *
683 vlib_cli_elog_clear (vlib_main_t * vm,
684 unformat_input_t * input, vlib_cli_command_t * cmd)
686 elog_reset_buffer (&vm->elog_main);
691 VLIB_CLI_COMMAND (elog_clear_cli, static) = {
692 .path = "event-logger clear",
693 .short_help = "Clear the event log",
694 .function = vlib_cli_elog_clear,
699 static clib_error_t *
700 elog_save_buffer (vlib_main_t * vm,
701 unformat_input_t * input, vlib_cli_command_t * cmd)
703 elog_main_t *em = &vm->elog_main;
704 char *file, *chroot_file;
705 clib_error_t *error = 0;
707 if (!unformat (input, "%s", &file))
709 vlib_cli_output (vm, "expected file name, got `%U'",
710 format_unformat_error, input);
714 /* It's fairly hard to get "../oopsie" through unformat; just in case */
715 if (strstr (file, "..") || index (file, '/'))
717 vlib_cli_output (vm, "illegal characters in filename '%s'", file);
721 chroot_file = (char *) format (0, "/tmp/%s%c", file, 0);
725 vlib_cli_output (vm, "Saving %wd of %wd events to %s",
726 elog_n_events_in_buffer (em),
727 elog_buffer_capacity (em), chroot_file);
729 vlib_worker_thread_barrier_sync (vm);
730 error = elog_write_file (em, chroot_file, 1 /* flush ring */ );
731 vlib_worker_thread_barrier_release (vm);
732 vec_free (chroot_file);
737 vlib_post_mortem_dump (void)
739 vlib_main_t *vm = &vlib_global_main;
740 elog_main_t *em = &vm->elog_main;
745 if ((vm->elog_post_mortem_dump + vm->dispatch_pcap_postmortem) == 0)
748 if (vm->dispatch_pcap_postmortem)
751 pcap_main_t *pm = &vm->dispatch_pcap_main;
753 pm->n_packets_to_capture = pm->n_packets_captured;
754 pm->file_name = (char *) format (0, "/tmp/dispatch_post_mortem.%d%c",
756 error = pcap_write (pm);
759 clib_error_report (error);
761 * We're in the middle of crashing. Don't try to free the filename.
765 if (vm->elog_post_mortem_dump)
767 filename = format (0, "/tmp/elog_post_mortem.%d%c", getpid (), 0);
768 error = elog_write_file (em, (char *) filename, 1 /* flush ring */ );
770 clib_error_report (error);
772 * We're in the middle of crashing. Don't try to free the filename.
778 VLIB_CLI_COMMAND (elog_save_cli, static) = {
779 .path = "event-logger save",
780 .short_help = "event-logger save <filename> (saves log in /tmp/<filename>)",
781 .function = elog_save_buffer,
785 static clib_error_t *
786 elog_stop (vlib_main_t * vm,
787 unformat_input_t * input, vlib_cli_command_t * cmd)
789 elog_main_t *em = &vm->elog_main;
791 em->n_total_events_disable_limit = em->n_total_events;
793 vlib_cli_output (vm, "Stopped the event logger...");
798 VLIB_CLI_COMMAND (elog_stop_cli, static) = {
799 .path = "event-logger stop",
800 .short_help = "Stop the event-logger",
801 .function = elog_stop,
805 static clib_error_t *
806 elog_restart (vlib_main_t * vm,
807 unformat_input_t * input, vlib_cli_command_t * cmd)
809 elog_main_t *em = &vm->elog_main;
811 em->n_total_events_disable_limit = ~0;
813 vlib_cli_output (vm, "Restarted the event logger...");
818 VLIB_CLI_COMMAND (elog_restart_cli, static) = {
819 .path = "event-logger restart",
820 .short_help = "Restart the event-logger",
821 .function = elog_restart,
825 static clib_error_t *
826 elog_resize_command_fn (vlib_main_t * vm,
827 unformat_input_t * input, vlib_cli_command_t * cmd)
829 elog_main_t *em = &vm->elog_main;
832 /* Stop the parade */
833 elog_reset_buffer (&vm->elog_main);
835 if (unformat (input, "%d", &tmp))
837 elog_alloc (em, tmp);
838 em->n_total_events_disable_limit = ~0;
841 return clib_error_return (0, "Must specify how many events in the ring");
843 vlib_cli_output (vm, "Resized ring and restarted the event logger...");
848 VLIB_CLI_COMMAND (elog_resize_cli, static) = {
849 .path = "event-logger resize",
850 .short_help = "event-logger resize <nnn>",
851 .function = elog_resize_command_fn,
855 #endif /* CLIB_UNIX */
858 elog_show_buffer_internal (vlib_main_t * vm, u32 n_events_to_show)
860 elog_main_t *em = &vm->elog_main;
861 elog_event_t *e, *es;
864 /* Show events in VLIB time since log clock starts after VLIB clock. */
865 dt = (em->init_time.cpu - vm->clib_time.init_cpu_time)
866 * vm->clib_time.seconds_per_clock;
868 es = elog_peek_events (em);
869 vlib_cli_output (vm, "%d of %d events in buffer, logger %s", vec_len (es),
871 em->n_total_events < em->n_total_events_disable_limit ?
872 "running" : "stopped");
875 vlib_cli_output (vm, "%18.9f: %U",
876 e->time + dt, format_elog_event, em, e);
878 if (n_events_to_show == 0)
885 static clib_error_t *
886 elog_show_buffer (vlib_main_t * vm,
887 unformat_input_t * input, vlib_cli_command_t * cmd)
889 u32 n_events_to_show;
890 clib_error_t *error = 0;
892 n_events_to_show = 250;
893 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
895 if (unformat (input, "%d", &n_events_to_show))
897 else if (unformat (input, "all"))
898 n_events_to_show = ~0;
900 return unformat_parse_error (input);
902 elog_show_buffer_internal (vm, n_events_to_show);
907 VLIB_CLI_COMMAND (elog_show_cli, static) = {
908 .path = "show event-logger",
909 .short_help = "Show event logger info",
910 .function = elog_show_buffer,
915 vlib_gdb_show_event_log (void)
917 elog_show_buffer_internal (vlib_get_main (), (u32) ~ 0);
921 vlib_elog_main_loop_event (vlib_main_t * vm,
923 u64 time, u32 n_vectors, u32 is_return)
925 vlib_main_t *evm = &vlib_global_main;
926 elog_main_t *em = &evm->elog_main;
927 int enabled = evm->elog_trace_graph_dispatch |
928 evm->elog_trace_graph_circuit;
930 if (PREDICT_FALSE (enabled && n_vectors))
932 if (PREDICT_FALSE (!elog_is_enabled (em)))
934 evm->elog_trace_graph_dispatch = 0;
935 evm->elog_trace_graph_circuit = 0;
939 (evm->elog_trace_graph_dispatch ||
940 (evm->elog_trace_graph_circuit &&
941 node_index == evm->elog_trace_graph_circuit_node_index)))
945 vec_elt_at_index (is_return
946 ? evm->node_return_elog_event_types
947 : evm->node_call_elog_event_types,
951 &vlib_worker_threads[vm->thread_index].elog_track
952 : &em->default_track),
953 /* data to log */ n_vectors);
958 #if VLIB_BUFFER_TRACE_TRAJECTORY > 0
959 void (*vlib_buffer_trace_trajectory_cb) (vlib_buffer_t * b, u32 node_index);
960 void (*vlib_buffer_trace_trajectory_init_cb) (vlib_buffer_t * b);
963 vlib_buffer_trace_trajectory_init (vlib_buffer_t * b)
965 if (PREDICT_TRUE (vlib_buffer_trace_trajectory_init_cb != 0))
967 (*vlib_buffer_trace_trajectory_init_cb) (b);
974 add_trajectory_trace (vlib_buffer_t * b, u32 node_index)
976 #if VLIB_BUFFER_TRACE_TRAJECTORY > 0
977 if (PREDICT_TRUE (vlib_buffer_trace_trajectory_cb != 0))
979 (*vlib_buffer_trace_trajectory_cb) (b, node_index);
984 u8 *format_vnet_buffer_flags (u8 * s, va_list * args) __attribute__ ((weak));
986 format_vnet_buffer_flags (u8 * s, va_list * args)
988 s = format (s, "BUG STUB %s", __FUNCTION__);
992 u8 *format_vnet_buffer_opaque (u8 * s, va_list * args) __attribute__ ((weak));
994 format_vnet_buffer_opaque (u8 * s, va_list * args)
996 s = format (s, "BUG STUB %s", __FUNCTION__);
1000 u8 *format_vnet_buffer_opaque2 (u8 * s, va_list * args)
1001 __attribute__ ((weak));
1003 format_vnet_buffer_opaque2 (u8 * s, va_list * args)
1005 s = format (s, "BUG STUB %s", __FUNCTION__);
1010 format_buffer_metadata (u8 * s, va_list * args)
1012 vlib_buffer_t *b = va_arg (*args, vlib_buffer_t *);
1014 s = format (s, "flags: %U\n", format_vnet_buffer_flags, b);
1015 s = format (s, "current_data: %d, current_length: %d\n",
1016 (i32) (b->current_data), (i32) (b->current_length));
1019 "current_config_index/punt_reason: %d, flow_id: %x, next_buffer: %x\n",
1020 b->current_config_index, b->flow_id, b->next_buffer);
1022 format (s, "error: %d, ref_count: %d, buffer_pool_index: %d\n",
1023 (u32) (b->error), (u32) (b->ref_count),
1024 (u32) (b->buffer_pool_index));
1026 format (s, "trace_handle: 0x%x, len_not_first_buf: %d\n", b->trace_handle,
1027 b->total_length_not_including_first_buffer);
1031 #define A(x) vec_add1(vm->pcap_buffer, (x))
1034 dispatch_pcap_trace (vlib_main_t * vm,
1035 vlib_node_runtime_t * node, vlib_frame_t * frame)
1038 vlib_buffer_t *bufs[VLIB_FRAME_SIZE], **bufp, *b;
1039 pcap_main_t *pm = &vlib_global_main.dispatch_pcap_main;
1040 vlib_trace_main_t *tm = &vm->trace_main;
1044 f64 time_now = vlib_time_now (vm);
1049 /* Input nodes don't have frames yet */
1050 if (frame == 0 || frame->n_vectors == 0)
1053 from = vlib_frame_vector_args (frame);
1054 vlib_get_buffers (vm, from, bufs, frame->n_vectors);
1057 n = vlib_get_node (vm, node->node_index);
1059 for (i = 0; i < frame->n_vectors; i++)
1061 if (PREDICT_TRUE (pm->n_packets_captured < pm->n_packets_to_capture))
1065 vec_reset_length (vm->pcap_buffer);
1068 /* Version, flags */
1069 A ((u8) VLIB_PCAP_MAJOR_VERSION);
1070 A ((u8) VLIB_PCAP_MINOR_VERSION);
1071 A (0 /* string_count */ );
1072 A (n->protocol_hint);
1074 /* Buffer index (big endian) */
1075 A ((from[i] >> 24) & 0xff);
1076 A ((from[i] >> 16) & 0xff);
1077 A ((from[i] >> 8) & 0xff);
1078 A ((from[i] >> 0) & 0xff);
1080 /* Node name, NULL-terminated ASCII */
1081 vm->pcap_buffer = format (vm->pcap_buffer, "%v%c", n->name, 0);
1084 vm->pcap_buffer = format (vm->pcap_buffer, "%U%c",
1085 format_buffer_metadata, b, 0);
1087 vm->pcap_buffer = format (vm->pcap_buffer, "%U%c",
1088 format_vnet_buffer_opaque, b, 0);
1090 vm->pcap_buffer = format (vm->pcap_buffer, "%U%c",
1091 format_vnet_buffer_opaque2, b, 0);
1094 /* Is this packet traced? */
1095 if (PREDICT_FALSE (b->flags & VLIB_BUFFER_IS_TRACED))
1097 vlib_trace_header_t **h
1098 = pool_elt_at_index (tm->trace_buffer_pool,
1099 vlib_buffer_get_trace_index (b));
1101 vm->pcap_buffer = format (vm->pcap_buffer, "%U%c",
1102 format_vlib_trace, vm, h[0], 0);
1106 /* Save the string count */
1107 vm->pcap_buffer[2] = string_count;
1109 /* Figure out how many bytes in the pcap trace */
1110 capture_size = vec_len (vm->pcap_buffer) +
1111 +vlib_buffer_length_in_chain (vm, b);
1113 clib_spinlock_lock_if_init (&pm->lock);
1114 n_left = clib_min (capture_size, 16384);
1115 d = pcap_add_packet (pm, time_now, n_left, capture_size);
1117 /* Copy the header */
1118 clib_memcpy_fast (d, vm->pcap_buffer, vec_len (vm->pcap_buffer));
1119 d += vec_len (vm->pcap_buffer);
1122 (vlib_buffer_length_in_chain (vm, b),
1123 (16384 - vec_len (vm->pcap_buffer)));
1124 /* Copy the packet data */
1127 u32 copy_length = clib_min ((u32) n_left, b->current_length);
1128 clib_memcpy_fast (d, b->data + b->current_data, copy_length);
1129 n_left -= b->current_length;
1132 d += b->current_length;
1133 ASSERT (b->flags & VLIB_BUFFER_NEXT_PRESENT);
1134 b = vlib_get_buffer (vm, b->next_buffer);
1136 clib_spinlock_unlock_if_init (&pm->lock);
1141 static_always_inline u64
1142 dispatch_node (vlib_main_t * vm,
1143 vlib_node_runtime_t * node,
1144 vlib_node_type_t type,
1145 vlib_node_state_t dispatch_state,
1146 vlib_frame_t * frame, u64 last_time_stamp)
1150 vlib_node_main_t *nm = &vm->node_main;
1151 vlib_next_frame_t *nf;
1155 vlib_node_t *n = vlib_get_node (vm, node->node_index);
1156 ASSERT (n->type == type);
1159 /* Only non-internal nodes may be disabled. */
1160 if (type != VLIB_NODE_TYPE_INTERNAL && node->state != dispatch_state)
1162 ASSERT (type != VLIB_NODE_TYPE_INTERNAL);
1163 return last_time_stamp;
1166 if ((type == VLIB_NODE_TYPE_PRE_INPUT || type == VLIB_NODE_TYPE_INPUT)
1167 && dispatch_state != VLIB_NODE_STATE_INTERRUPT)
1169 u32 c = node->input_main_loops_per_call;
1170 /* Only call node when count reaches zero. */
1173 node->input_main_loops_per_call = c - 1;
1174 return last_time_stamp;
1178 /* Speculatively prefetch next frames. */
1179 if (node->n_next_nodes > 0)
1181 nf = vec_elt_at_index (nm->next_frames, node->next_frame_index);
1182 CLIB_PREFETCH (nf, 4 * sizeof (nf[0]), WRITE);
1185 vm->cpu_time_last_node_dispatch = last_time_stamp;
1187 vlib_elog_main_loop_event (vm, node->node_index,
1188 last_time_stamp, frame ? frame->n_vectors : 0,
1191 vlib_node_runtime_perf_counter (vm, node, frame, 0, last_time_stamp,
1192 VLIB_NODE_RUNTIME_PERF_BEFORE);
1195 * Turn this on if you run into
1196 * "bad monkey" contexts, and you want to know exactly
1197 * which nodes they've visited... See ixge.c...
1199 if (VLIB_BUFFER_TRACE_TRAJECTORY && frame)
1203 from = vlib_frame_vector_args (frame);
1204 for (i = 0; i < frame->n_vectors; i++)
1206 vlib_buffer_t *b = vlib_get_buffer (vm, from[i]);
1207 add_trajectory_trace (b, node->node_index);
1209 if (PREDICT_FALSE (vm->dispatch_pcap_enable))
1210 dispatch_pcap_trace (vm, node, frame);
1212 if (PREDICT_TRUE (vm->dispatch_wrapper_fn == 0))
1213 n = node->function (vm, node, frame);
1215 n = vm->dispatch_wrapper_fn (vm, node, frame);
1219 if (PREDICT_FALSE (vm->dispatch_pcap_enable))
1220 dispatch_pcap_trace (vm, node, frame);
1222 if (PREDICT_TRUE (vm->dispatch_wrapper_fn == 0))
1223 n = node->function (vm, node, frame);
1225 n = vm->dispatch_wrapper_fn (vm, node, frame);
1228 t = clib_cpu_time_now ();
1230 vlib_node_runtime_perf_counter (vm, node, frame, n, t,
1231 VLIB_NODE_RUNTIME_PERF_AFTER);
1233 vlib_elog_main_loop_event (vm, node->node_index, t, n, 1 /* is_after */ );
1235 vm->main_loop_vectors_processed += n;
1236 vm->main_loop_nodes_processed += n > 0;
1238 v = vlib_node_runtime_update_stats (vm, node,
1241 /* n_clocks */ t - last_time_stamp);
1243 /* When in interrupt mode and vector rate crosses threshold switch to
1245 if (PREDICT_FALSE ((dispatch_state == VLIB_NODE_STATE_INTERRUPT)
1246 || (dispatch_state == VLIB_NODE_STATE_POLLING
1249 VLIB_NODE_FLAG_SWITCH_FROM_INTERRUPT_TO_POLLING_MODE))))
1252 ELOG_TYPE_DECLARE (e) =
1254 .function = (char *) __FUNCTION__,
1255 .format = "%s vector length %d, switching to %s",
1256 .format_args = "T4i4t4",
1257 .n_enum_strings = 2,
1259 "interrupt", "polling",
1265 u32 node_name, vector_length, is_polling;
1268 if ((dispatch_state == VLIB_NODE_STATE_INTERRUPT
1269 && v >= nm->polling_threshold_vector_length) &&
1271 VLIB_NODE_FLAG_SWITCH_FROM_INTERRUPT_TO_POLLING_MODE))
1273 vlib_node_t *n = vlib_get_node (vm, node->node_index);
1274 n->state = VLIB_NODE_STATE_POLLING;
1275 node->state = VLIB_NODE_STATE_POLLING;
1277 ~VLIB_NODE_FLAG_SWITCH_FROM_POLLING_TO_INTERRUPT_MODE;
1278 node->flags |= VLIB_NODE_FLAG_SWITCH_FROM_INTERRUPT_TO_POLLING_MODE;
1279 nm->input_node_counts_by_state[VLIB_NODE_STATE_INTERRUPT] -= 1;
1280 nm->input_node_counts_by_state[VLIB_NODE_STATE_POLLING] += 1;
1282 if (PREDICT_FALSE (vlib_global_main.elog_trace_graph_dispatch))
1284 vlib_worker_thread_t *w = vlib_worker_threads
1287 ed = ELOG_TRACK_DATA (&vlib_global_main.elog_main, e,
1289 ed->node_name = n->name_elog_string;
1290 ed->vector_length = v;
1294 else if (dispatch_state == VLIB_NODE_STATE_POLLING
1295 && v <= nm->interrupt_threshold_vector_length)
1297 vlib_node_t *n = vlib_get_node (vm, node->node_index);
1299 VLIB_NODE_FLAG_SWITCH_FROM_POLLING_TO_INTERRUPT_MODE)
1301 /* Switch to interrupt mode after dispatch in polling one more time.
1302 This allows driver to re-enable interrupts. */
1303 n->state = VLIB_NODE_STATE_INTERRUPT;
1304 node->state = VLIB_NODE_STATE_INTERRUPT;
1306 ~VLIB_NODE_FLAG_SWITCH_FROM_INTERRUPT_TO_POLLING_MODE;
1307 nm->input_node_counts_by_state[VLIB_NODE_STATE_POLLING] -= 1;
1308 nm->input_node_counts_by_state[VLIB_NODE_STATE_INTERRUPT] += 1;
1313 vlib_worker_thread_t *w = vlib_worker_threads
1316 VLIB_NODE_FLAG_SWITCH_FROM_POLLING_TO_INTERRUPT_MODE;
1317 if (PREDICT_FALSE (vlib_global_main.elog_trace_graph_dispatch))
1319 ed = ELOG_TRACK_DATA (&vlib_global_main.elog_main, e,
1321 ed->node_name = n->name_elog_string;
1322 ed->vector_length = v;
1333 dispatch_pending_node (vlib_main_t * vm, uword pending_frame_index,
1334 u64 last_time_stamp)
1336 vlib_node_main_t *nm = &vm->node_main;
1338 vlib_next_frame_t *nf, nf_placeholder;
1339 vlib_node_runtime_t *n;
1340 vlib_frame_t *restore_frame;
1341 vlib_pending_frame_t *p;
1343 /* See comment below about dangling references to nm->pending_frames */
1344 p = nm->pending_frames + pending_frame_index;
1346 n = vec_elt_at_index (nm->nodes_by_type[VLIB_NODE_TYPE_INTERNAL],
1347 p->node_runtime_index);
1349 f = vlib_get_frame (vm, p->frame);
1350 if (p->next_frame_index == VLIB_PENDING_FRAME_NO_NEXT_FRAME)
1352 /* No next frame: so use placeholder on stack. */
1353 nf = &nf_placeholder;
1354 nf->flags = f->frame_flags & VLIB_NODE_FLAG_TRACE;
1358 nf = vec_elt_at_index (nm->next_frames, p->next_frame_index);
1360 ASSERT (f->frame_flags & VLIB_FRAME_IS_ALLOCATED);
1362 /* Force allocation of new frame while current frame is being
1364 restore_frame = NULL;
1365 if (nf->frame == p->frame)
1368 nf->flags &= ~VLIB_FRAME_IS_ALLOCATED;
1369 if (!(n->flags & VLIB_NODE_FLAG_FRAME_NO_FREE_AFTER_DISPATCH))
1370 restore_frame = p->frame;
1373 /* Frame must be pending. */
1374 ASSERT (f->frame_flags & VLIB_FRAME_PENDING);
1375 ASSERT (f->n_vectors > 0);
1377 /* Copy trace flag from next frame to node.
1378 Trace flag indicates that at least one vector in the dispatched
1380 n->flags &= ~VLIB_NODE_FLAG_TRACE;
1381 n->flags |= (nf->flags & VLIB_FRAME_TRACE) ? VLIB_NODE_FLAG_TRACE : 0;
1382 nf->flags &= ~VLIB_FRAME_TRACE;
1384 last_time_stamp = dispatch_node (vm, n,
1385 VLIB_NODE_TYPE_INTERNAL,
1386 VLIB_NODE_STATE_POLLING,
1387 f, last_time_stamp);
1388 /* Internal node vector-rate accounting, for summary stats */
1389 vm->internal_node_vectors += f->n_vectors;
1390 vm->internal_node_calls++;
1391 vm->internal_node_last_vectors_per_main_loop =
1392 (f->n_vectors > vm->internal_node_last_vectors_per_main_loop) ?
1393 f->n_vectors : vm->internal_node_last_vectors_per_main_loop;
1395 f->frame_flags &= ~(VLIB_FRAME_PENDING | VLIB_FRAME_NO_APPEND);
1397 /* Frame is ready to be used again, so restore it. */
1398 if (restore_frame != NULL)
1401 * We musn't restore a frame that is flagged to be freed. This
1402 * shouldn't happen since frames to be freed post dispatch are
1403 * those used when the to-node frame becomes full i.e. they form a
1404 * sort of queue of frames to a single node. If we get here then
1405 * the to-node frame and the pending frame *were* the same, and so
1406 * we removed the to-node frame. Therefore this frame is no
1407 * longer part of the queue for that node and hence it cannot be
1410 ASSERT (!(f->frame_flags & VLIB_FRAME_FREE_AFTER_DISPATCH));
1413 * NB: dispatching node n can result in the creation and scheduling
1414 * of new frames, and hence in the reallocation of nm->pending_frames.
1415 * Recompute p, or no supper. This was broken for more than 10 years.
1417 p = nm->pending_frames + pending_frame_index;
1420 * p->next_frame_index can change during node dispatch if node
1421 * function decides to change graph hook up.
1423 nf = vec_elt_at_index (nm->next_frames, p->next_frame_index);
1424 nf->flags |= VLIB_FRAME_IS_ALLOCATED;
1426 if (NULL == nf->frame)
1428 /* no new frame has been assigned to this node, use the saved one */
1429 nf->frame = restore_frame;
1434 /* The node has gained a frame, implying packets from the current frame
1435 were re-queued to this same node. we don't need the saved one
1437 vlib_frame_free (vm, n, f);
1442 if (f->frame_flags & VLIB_FRAME_FREE_AFTER_DISPATCH)
1444 ASSERT (!(n->flags & VLIB_NODE_FLAG_FRAME_NO_FREE_AFTER_DISPATCH));
1445 vlib_frame_free (vm, n, f);
1449 return last_time_stamp;
1453 vlib_process_stack_is_valid (vlib_process_t * p)
1455 return p->stack[0] == VLIB_PROCESS_STACK_MAGIC;
1461 vlib_process_t *process;
1462 vlib_frame_t *frame;
1463 } vlib_process_bootstrap_args_t;
1465 /* Called in process stack. */
1467 vlib_process_bootstrap (uword _a)
1469 vlib_process_bootstrap_args_t *a;
1471 vlib_node_runtime_t *node;
1476 a = uword_to_pointer (_a, vlib_process_bootstrap_args_t *);
1480 vlib_process_finish_switch_stack (vm);
1483 node = &p->node_runtime;
1485 n = node->function (vm, node, f);
1487 ASSERT (vlib_process_stack_is_valid (p));
1489 vlib_process_start_switch_stack (vm, 0);
1490 clib_longjmp (&p->return_longjmp, n);
1495 /* Called in main stack. */
1496 static_always_inline uword
1497 vlib_process_startup (vlib_main_t * vm, vlib_process_t * p, vlib_frame_t * f)
1499 vlib_process_bootstrap_args_t a;
1506 r = clib_setjmp (&p->return_longjmp, VLIB_PROCESS_RETURN_LONGJMP_RETURN);
1507 if (r == VLIB_PROCESS_RETURN_LONGJMP_RETURN)
1509 vlib_process_start_switch_stack (vm, p);
1510 r = clib_calljmp (vlib_process_bootstrap, pointer_to_uword (&a),
1511 (void *) p->stack + (1 << p->log2_n_stack_bytes));
1514 vlib_process_finish_switch_stack (vm);
1519 static_always_inline uword
1520 vlib_process_resume (vlib_main_t * vm, vlib_process_t * p)
1523 p->flags &= ~(VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_CLOCK
1524 | VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_EVENT
1525 | VLIB_PROCESS_RESUME_PENDING);
1526 r = clib_setjmp (&p->return_longjmp, VLIB_PROCESS_RETURN_LONGJMP_RETURN);
1527 if (r == VLIB_PROCESS_RETURN_LONGJMP_RETURN)
1529 vlib_process_start_switch_stack (vm, p);
1530 clib_longjmp (&p->resume_longjmp, VLIB_PROCESS_RESUME_LONGJMP_RESUME);
1533 vlib_process_finish_switch_stack (vm);
1538 dispatch_process (vlib_main_t * vm,
1539 vlib_process_t * p, vlib_frame_t * f, u64 last_time_stamp)
1541 vlib_node_main_t *nm = &vm->node_main;
1542 vlib_node_runtime_t *node_runtime = &p->node_runtime;
1543 vlib_node_t *node = vlib_get_node (vm, node_runtime->node_index);
1544 u32 old_process_index;
1546 uword n_vectors, is_suspend;
1548 if (node->state != VLIB_NODE_STATE_POLLING
1549 || (p->flags & (VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_CLOCK
1550 | VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_EVENT)))
1551 return last_time_stamp;
1553 p->flags |= VLIB_PROCESS_IS_RUNNING;
1555 t = last_time_stamp;
1556 vlib_elog_main_loop_event (vm, node_runtime->node_index, t,
1557 f ? f->n_vectors : 0, /* is_after */ 0);
1559 /* Save away current process for suspend. */
1560 old_process_index = nm->current_process_index;
1561 nm->current_process_index = node->runtime_index;
1563 vlib_node_runtime_perf_counter (vm, node_runtime, f, 0, last_time_stamp,
1564 VLIB_NODE_RUNTIME_PERF_BEFORE);
1566 n_vectors = vlib_process_startup (vm, p, f);
1568 nm->current_process_index = old_process_index;
1570 ASSERT (n_vectors != VLIB_PROCESS_RETURN_LONGJMP_RETURN);
1571 is_suspend = n_vectors == VLIB_PROCESS_RETURN_LONGJMP_SUSPEND;
1574 vlib_pending_frame_t *pf;
1577 pool_get (nm->suspended_process_frames, pf);
1578 pf->node_runtime_index = node->runtime_index;
1580 pf->next_frame_index = ~0;
1583 p->suspended_process_frame_index = pf - nm->suspended_process_frames;
1585 if (p->flags & VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_CLOCK)
1587 TWT (tw_timer_wheel) * tw =
1588 (TWT (tw_timer_wheel) *) nm->timing_wheel;
1589 p->stop_timer_handle =
1590 TW (tw_timer_start) (tw,
1591 vlib_timing_wheel_data_set_suspended_process
1592 (node->runtime_index) /* [sic] pool idex */ ,
1594 p->resume_clock_interval);
1598 p->flags &= ~VLIB_PROCESS_IS_RUNNING;
1600 t = clib_cpu_time_now ();
1602 vlib_elog_main_loop_event (vm, node_runtime->node_index, t, is_suspend,
1605 vlib_node_runtime_perf_counter (vm, node_runtime, f, n_vectors, t,
1606 VLIB_NODE_RUNTIME_PERF_AFTER);
1608 vlib_process_update_stats (vm, p,
1609 /* n_calls */ !is_suspend,
1610 /* n_vectors */ n_vectors,
1611 /* n_clocks */ t - last_time_stamp);
1617 vlib_start_process (vlib_main_t * vm, uword process_index)
1619 vlib_node_main_t *nm = &vm->node_main;
1620 vlib_process_t *p = vec_elt (nm->processes, process_index);
1621 dispatch_process (vm, p, /* frame */ 0, /* cpu_time_now */ 0);
1625 dispatch_suspended_process (vlib_main_t * vm,
1626 uword process_index, u64 last_time_stamp)
1628 vlib_node_main_t *nm = &vm->node_main;
1629 vlib_node_runtime_t *node_runtime;
1633 vlib_pending_frame_t *pf;
1634 u64 t, n_vectors, is_suspend;
1636 t = last_time_stamp;
1638 p = vec_elt (nm->processes, process_index);
1639 if (PREDICT_FALSE (!(p->flags & VLIB_PROCESS_IS_RUNNING)))
1640 return last_time_stamp;
1642 ASSERT (p->flags & (VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_CLOCK
1643 | VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_EVENT));
1645 pf = pool_elt_at_index (nm->suspended_process_frames,
1646 p->suspended_process_frame_index);
1648 node_runtime = &p->node_runtime;
1649 node = vlib_get_node (vm, node_runtime->node_index);
1652 vlib_elog_main_loop_event (vm, node_runtime->node_index, t,
1653 f ? f->n_vectors : 0, /* is_after */ 0);
1655 /* Save away current process for suspend. */
1656 nm->current_process_index = node->runtime_index;
1658 vlib_node_runtime_perf_counter (vm, node_runtime, f, 0, last_time_stamp,
1659 VLIB_NODE_RUNTIME_PERF_BEFORE);
1661 n_vectors = vlib_process_resume (vm, p);
1662 t = clib_cpu_time_now ();
1664 nm->current_process_index = ~0;
1666 is_suspend = n_vectors == VLIB_PROCESS_RETURN_LONGJMP_SUSPEND;
1669 /* Suspend it again. */
1672 if (p->flags & VLIB_PROCESS_IS_SUSPENDED_WAITING_FOR_CLOCK)
1674 p->stop_timer_handle =
1675 TW (tw_timer_start) ((TWT (tw_timer_wheel) *) nm->timing_wheel,
1676 vlib_timing_wheel_data_set_suspended_process
1677 (node->runtime_index) /* [sic] pool idex */ ,
1679 p->resume_clock_interval);
1684 p->flags &= ~VLIB_PROCESS_IS_RUNNING;
1685 pool_put_index (nm->suspended_process_frames,
1686 p->suspended_process_frame_index);
1687 p->suspended_process_frame_index = ~0;
1690 t = clib_cpu_time_now ();
1691 vlib_elog_main_loop_event (vm, node_runtime->node_index, t, !is_suspend,
1694 vlib_node_runtime_perf_counter (vm, node_runtime, f, n_vectors, t,
1695 VLIB_NODE_RUNTIME_PERF_AFTER);
1697 vlib_process_update_stats (vm, p,
1698 /* n_calls */ !is_suspend,
1699 /* n_vectors */ n_vectors,
1700 /* n_clocks */ t - last_time_stamp);
1705 void vl_api_send_pending_rpc_requests (vlib_main_t *) __attribute__ ((weak));
1707 vl_api_send_pending_rpc_requests (vlib_main_t * vm)
1711 static_always_inline u64
1712 dispatch_pending_interrupts (vlib_main_t * vm, vlib_node_main_t * nm,
1714 vlib_node_interrupt_t * interrupts)
1716 vlib_node_runtime_t *n;
1718 for (int i = 0; i < _vec_len (interrupts); i++)
1720 vlib_node_interrupt_t *in;
1721 in = vec_elt_at_index (interrupts, i);
1722 n = vec_elt_at_index (nm->nodes_by_type[VLIB_NODE_TYPE_INPUT],
1723 in->node_runtime_index);
1724 n->interrupt_data = in->data;
1725 cpu_time_now = dispatch_node (vm, n, VLIB_NODE_TYPE_INPUT,
1726 VLIB_NODE_STATE_INTERRUPT, /* frame */ 0,
1729 return cpu_time_now;
1733 pcap_postmortem_reset (vlib_main_t * vm)
1735 pcap_main_t *pm = &vm->dispatch_pcap_main;
1737 /* Reset the trace buffer and capture count */
1738 clib_spinlock_lock_if_init (&pm->lock);
1739 vec_reset_length (pm->pcap_data);
1740 pm->n_packets_captured = 0;
1741 clib_spinlock_unlock_if_init (&pm->lock);
1745 static_always_inline void
1746 vlib_main_or_worker_loop (vlib_main_t * vm, int is_main)
1748 vlib_node_main_t *nm = &vm->node_main;
1749 vlib_thread_main_t *tm = vlib_get_thread_main ();
1753 vlib_frame_queue_main_t *fqm;
1754 u32 frame_queue_check_counter = 0;
1755 vlib_node_interrupt_t *empty_int_list = 0;
1757 /* Initialize pending node vector. */
1760 vec_resize (nm->pending_frames, 32);
1761 _vec_len (nm->pending_frames) = 0;
1764 /* Mark time of main loop start. */
1767 cpu_time_now = vm->clib_time.last_cpu_time;
1768 vm->cpu_time_main_loop_start = cpu_time_now;
1771 cpu_time_now = clib_cpu_time_now ();
1773 /* Pre-allocate interupt runtime indices and lock. */
1774 vec_alloc (nm->pending_local_interrupts, 32);
1775 vec_alloc (nm->pending_remote_interrupts, 32);
1776 vec_alloc (empty_int_list, 32);
1777 vec_alloc_aligned (nm->pending_remote_interrupts_notify, 1,
1778 CLIB_CACHE_LINE_BYTES);
1779 clib_spinlock_init (&nm->pending_interrupt_lock);
1781 /* Pre-allocate expired nodes. */
1782 if (!nm->polling_threshold_vector_length)
1783 nm->polling_threshold_vector_length = 10;
1784 if (!nm->interrupt_threshold_vector_length)
1785 nm->interrupt_threshold_vector_length = 5;
1787 vm->cpu_id = clib_get_current_cpu_id ();
1788 vm->numa_node = clib_get_current_numa_node ();
1789 os_set_numa_index (vm->numa_node);
1791 /* Start all processes. */
1797 * Perform an initial barrier sync. Pays no attention to
1798 * the barrier sync hold-down timer scheme, which won't work
1799 * at this point in time.
1801 vlib_worker_thread_initial_barrier_sync_and_release (vm);
1803 nm->current_process_index = ~0;
1804 for (i = 0; i < vec_len (nm->processes); i++)
1805 cpu_time_now = dispatch_process (vm, nm->processes[i], /* frame */ 0,
1811 vlib_node_runtime_t *n;
1813 if (PREDICT_FALSE (_vec_len (vm->pending_rpc_requests) > 0))
1816 vl_api_send_pending_rpc_requests (vm);
1820 vlib_worker_thread_barrier_check ();
1822 if (PREDICT_FALSE (vm->check_frame_queues + frame_queue_check_counter))
1826 if (vm->check_frame_queues)
1828 frame_queue_check_counter = 100;
1829 vm->check_frame_queues = 0;
1832 vec_foreach (fqm, tm->frame_queue_mains)
1833 processed += vlib_frame_queue_dequeue (vm, fqm);
1835 /* No handoff queue work found? */
1837 frame_queue_check_counter = 100;
1839 frame_queue_check_counter--;
1842 if (PREDICT_FALSE (vec_len (vm->worker_thread_main_loop_callbacks)))
1843 clib_call_callbacks (vm->worker_thread_main_loop_callbacks, vm,
1847 * When trying to understand aggravating, hard-to-reproduce
1848 * bugs: reset / restart the pcap dispatch trace once per
1849 * main thread dispatch cycle. All threads share the same
1850 * (spinlock-protected) dispatch trace buffer. It might take
1851 * a few tries to capture a good post-mortem trace of
1852 * a multi-thread issue. Best we can do without a big refactor job.
1854 if (is_main && PREDICT_FALSE (vm->dispatch_pcap_postmortem != 0))
1855 pcap_postmortem_reset (vm);
1857 /* Process pre-input nodes. */
1858 cpu_time_now = clib_cpu_time_now ();
1859 vec_foreach (n, nm->nodes_by_type[VLIB_NODE_TYPE_PRE_INPUT])
1860 cpu_time_now = dispatch_node (vm, n,
1861 VLIB_NODE_TYPE_PRE_INPUT,
1862 VLIB_NODE_STATE_POLLING,
1866 /* Next process input nodes. */
1867 vec_foreach (n, nm->nodes_by_type[VLIB_NODE_TYPE_INPUT])
1868 cpu_time_now = dispatch_node (vm, n,
1869 VLIB_NODE_TYPE_INPUT,
1870 VLIB_NODE_STATE_POLLING,
1874 if (PREDICT_TRUE (is_main && vm->queue_signal_pending == 0))
1875 vm->queue_signal_callback (vm);
1877 /* handle local interruots */
1878 if (_vec_len (nm->pending_local_interrupts))
1880 vlib_node_interrupt_t *interrupts = nm->pending_local_interrupts;
1881 nm->pending_local_interrupts = empty_int_list;
1882 cpu_time_now = dispatch_pending_interrupts (vm, nm, cpu_time_now,
1884 empty_int_list = interrupts;
1885 vec_reset_length (empty_int_list);
1888 /* handle remote interruots */
1889 if (PREDICT_FALSE (_vec_len (nm->pending_remote_interrupts)))
1891 vlib_node_interrupt_t *interrupts;
1893 /* at this point it is known that
1894 * vec_len (nm->pending_local_interrupts) is zero so we quickly swap
1895 * local and remote vector under the spinlock */
1896 clib_spinlock_lock (&nm->pending_interrupt_lock);
1897 interrupts = nm->pending_remote_interrupts;
1898 nm->pending_remote_interrupts = empty_int_list;
1899 *nm->pending_remote_interrupts_notify = 0;
1900 clib_spinlock_unlock (&nm->pending_interrupt_lock);
1902 cpu_time_now = dispatch_pending_interrupts (vm, nm, cpu_time_now,
1904 empty_int_list = interrupts;
1905 vec_reset_length (empty_int_list);
1908 /* Input nodes may have added work to the pending vector.
1909 Process pending vector until there is nothing left.
1910 All pending vectors will be processed from input -> output. */
1911 for (i = 0; i < _vec_len (nm->pending_frames); i++)
1912 cpu_time_now = dispatch_pending_node (vm, i, cpu_time_now);
1913 /* Reset pending vector for next iteration. */
1914 _vec_len (nm->pending_frames) = 0;
1919 ELOG_TYPE_DECLARE (es) =
1921 .format = "process tw start",
1924 ELOG_TYPE_DECLARE (ee) =
1926 .format = "process tw end: %d",
1927 .format_args = "i4",
1936 /* Check if process nodes have expired from timing wheel. */
1937 ASSERT (nm->data_from_advancing_timing_wheel != 0);
1939 if (PREDICT_FALSE (vm->elog_trace_graph_dispatch))
1940 ed = ELOG_DATA (&vlib_global_main.elog_main, es);
1942 nm->data_from_advancing_timing_wheel =
1943 TW (tw_timer_expire_timers_vec)
1944 ((TWT (tw_timer_wheel) *) nm->timing_wheel, vlib_time_now (vm),
1945 nm->data_from_advancing_timing_wheel);
1947 ASSERT (nm->data_from_advancing_timing_wheel != 0);
1949 if (PREDICT_FALSE (vm->elog_trace_graph_dispatch))
1951 ed = ELOG_DATA (&vlib_global_main.elog_main, ee);
1953 _vec_len (nm->data_from_advancing_timing_wheel);
1957 (_vec_len (nm->data_from_advancing_timing_wheel) > 0))
1961 for (i = 0; i < _vec_len (nm->data_from_advancing_timing_wheel);
1964 u32 d = nm->data_from_advancing_timing_wheel[i];
1965 u32 di = vlib_timing_wheel_data_get_index (d);
1967 if (vlib_timing_wheel_data_is_timed_event (d))
1969 vlib_signal_timed_event_data_t *te =
1970 pool_elt_at_index (nm->signal_timed_event_data_pool,
1973 vlib_get_node (vm, te->process_node_index);
1975 vec_elt (nm->processes, n->runtime_index);
1978 vlib_process_signal_event_helper (nm, n, p,
1979 te->event_type_index,
1981 te->n_data_elt_bytes);
1982 if (te->n_data_bytes < sizeof (te->inline_event_data))
1983 clib_memcpy_fast (data, te->inline_event_data,
1987 clib_memcpy_fast (data, te->event_data_as_vector,
1989 vec_free (te->event_data_as_vector);
1991 pool_put (nm->signal_timed_event_data_pool, te);
1995 cpu_time_now = clib_cpu_time_now ();
1997 dispatch_suspended_process (vm, di, cpu_time_now);
2000 _vec_len (nm->data_from_advancing_timing_wheel) = 0;
2003 vlib_increment_main_loop_counter (vm);
2004 /* Record time stamp in case there are no enabled nodes and above
2005 calls do not update time stamp. */
2006 cpu_time_now = clib_cpu_time_now ();
2007 vm->loops_this_reporting_interval++;
2008 now = clib_time_now_internal (&vm->clib_time, cpu_time_now);
2009 /* Time to update loops_per_second? */
2010 if (PREDICT_FALSE (now >= vm->loop_interval_end))
2012 /* Next sample ends in 20ms */
2013 if (vm->loop_interval_start)
2015 f64 this_loops_per_second;
2017 this_loops_per_second =
2018 ((f64) vm->loops_this_reporting_interval) / (now -
2019 vm->loop_interval_start);
2021 vm->loops_per_second =
2022 vm->loops_per_second * vm->damping_constant +
2023 (1.0 - vm->damping_constant) * this_loops_per_second;
2024 if (vm->loops_per_second != 0.0)
2025 vm->seconds_per_loop = 1.0 / vm->loops_per_second;
2027 vm->seconds_per_loop = 0.0;
2029 /* New interval starts now, and ends in 20ms */
2030 vm->loop_interval_start = now;
2031 vm->loop_interval_end = now + 2e-4;
2032 vm->loops_this_reporting_interval = 0;
2038 vlib_main_loop (vlib_main_t * vm)
2040 vlib_main_or_worker_loop (vm, /* is_main */ 1);
2044 vlib_worker_loop (vlib_main_t * vm)
2046 vlib_main_or_worker_loop (vm, /* is_main */ 0);
2049 vlib_main_t vlib_global_main;
2051 static clib_error_t *
2052 vlib_main_configure (vlib_main_t * vm, unformat_input_t * input)
2054 int turn_on_mem_trace = 0;
2056 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
2058 if (unformat (input, "memory-trace"))
2059 turn_on_mem_trace = 1;
2061 else if (unformat (input, "elog-events %d",
2062 &vm->configured_elog_ring_size))
2063 vm->configured_elog_ring_size =
2064 1 << max_log2 (vm->configured_elog_ring_size);
2065 else if (unformat (input, "elog-post-mortem-dump"))
2066 vm->elog_post_mortem_dump = 1;
2067 else if (unformat (input, "buffer-alloc-success-rate %f",
2068 &vm->buffer_alloc_success_rate))
2070 if (VLIB_BUFFER_ALLOC_FAULT_INJECTOR == 0)
2071 return clib_error_return
2072 (0, "Buffer fault injection not configured");
2074 else if (unformat (input, "buffer-alloc-success-seed %u",
2075 &vm->buffer_alloc_success_seed))
2077 if (VLIB_BUFFER_ALLOC_FAULT_INJECTOR == 0)
2078 return clib_error_return
2079 (0, "Buffer fault injection not configured");
2082 return unformat_parse_error (input);
2085 unformat_free (input);
2087 /* Enable memory trace as early as possible. */
2088 if (turn_on_mem_trace)
2094 VLIB_EARLY_CONFIG_FUNCTION (vlib_main_configure, "vlib");
2097 placeholder_queue_signal_callback (vlib_main_t * vm)
2101 #define foreach_weak_reference_stub \
2102 _(vlib_map_stat_segment_init) \
2104 _(vlibmemory_init) \
2105 _(map_api_segment_init)
2108 clib_error_t *name (vlib_main_t *vm) __attribute__((weak)); \
2109 clib_error_t *name (vlib_main_t *vm) { return 0; }
2110 foreach_weak_reference_stub;
2113 void vl_api_set_elog_main (elog_main_t * m) __attribute__ ((weak));
2115 vl_api_set_elog_main (elog_main_t * m)
2117 clib_warning ("STUB");
2120 int vl_api_set_elog_trace_api_messages (int enable) __attribute__ ((weak));
2122 vl_api_set_elog_trace_api_messages (int enable)
2124 clib_warning ("STUB");
2128 int vl_api_get_elog_trace_api_messages (void) __attribute__ ((weak));
2130 vl_api_get_elog_trace_api_messages (void)
2132 clib_warning ("STUB");
2136 /* Main function. */
2138 vlib_main (vlib_main_t * volatile vm, unformat_input_t * input)
2140 clib_error_t *volatile error;
2141 vlib_node_main_t *nm = &vm->node_main;
2143 vm->queue_signal_callback = placeholder_queue_signal_callback;
2145 /* Reconfigure event log which is enabled very early */
2146 if (vm->configured_elog_ring_size &&
2147 vm->configured_elog_ring_size != vm->elog_main.event_ring_size)
2148 elog_resize (&vm->elog_main, vm->configured_elog_ring_size);
2149 vl_api_set_elog_main (&vm->elog_main);
2150 (void) vl_api_set_elog_trace_api_messages (1);
2156 if ((error = vlib_physmem_init (vm)))
2158 clib_error_report (error);
2162 if ((error = vlib_map_stat_segment_init (vm)))
2164 clib_error_report (error);
2168 if ((error = vlib_buffer_main_init (vm)))
2170 clib_error_report (error);
2174 if ((error = vlib_thread_init (vm)))
2176 clib_error_report (error);
2180 /* Register static nodes so that init functions may use them. */
2181 vlib_register_all_static_nodes (vm);
2183 /* Set seed for random number generator.
2184 Allow user to specify seed to make random sequence deterministic. */
2185 if (!unformat (input, "seed %wd", &vm->random_seed))
2186 vm->random_seed = clib_cpu_time_now ();
2187 clib_random_buffer_init (&vm->random_buffer, vm->random_seed);
2189 /* Initialize node graph. */
2190 if ((error = vlib_node_main_init (vm)))
2192 /* Arrange for graph hook up error to not be fatal when debugging. */
2194 clib_error_report (error);
2199 /* Direct call / weak reference, for vlib standalone use-cases */
2200 if ((error = vpe_api_init (vm)))
2202 clib_error_report (error);
2206 if ((error = vlibmemory_init (vm)))
2208 clib_error_report (error);
2212 if ((error = map_api_segment_init (vm)))
2214 clib_error_report (error);
2218 /* See unix/main.c; most likely already set up */
2219 if (vm->init_functions_called == 0)
2220 vm->init_functions_called = hash_create (0, /* value bytes */ 0);
2221 if ((error = vlib_call_all_init_functions (vm)))
2224 nm->timing_wheel = clib_mem_alloc_aligned (sizeof (TWT (tw_timer_wheel)),
2225 CLIB_CACHE_LINE_BYTES);
2227 vec_validate (nm->data_from_advancing_timing_wheel, 10);
2228 _vec_len (nm->data_from_advancing_timing_wheel) = 0;
2230 /* Create the process timing wheel */
2231 TW (tw_timer_wheel_init) ((TWT (tw_timer_wheel) *) nm->timing_wheel,
2232 0 /* no callback */ ,
2233 10e-6 /* timer period 10us */ ,
2234 ~0 /* max expirations per call */ );
2236 vec_validate (vm->pending_rpc_requests, 0);
2237 _vec_len (vm->pending_rpc_requests) = 0;
2238 vec_validate (vm->processing_rpc_requests, 0);
2239 _vec_len (vm->processing_rpc_requests) = 0;
2241 /* Default params for the buffer allocator fault injector, if configured */
2242 if (VLIB_BUFFER_ALLOC_FAULT_INJECTOR > 0)
2244 vm->buffer_alloc_success_seed = 0xdeaddabe;
2245 vm->buffer_alloc_success_rate = 0.80;
2248 if ((error = vlib_call_all_config_functions (vm, input, 0 /* is_early */ )))
2252 * Use exponential smoothing, with a half-life of 1 second
2253 * reported_rate(t) = reported_rate(t-1) * K + rate(t)*(1-K)
2255 * Sample every 20ms, aka 50 samples per second
2256 * K = exp (-1.0/20.0);
2259 vm->damping_constant = exp (-1.0 / 20.0);
2261 /* Sort per-thread init functions before we start threads */
2262 vlib_sort_init_exit_functions (&vm->worker_init_function_registrations);
2264 /* Call all main loop enter functions. */
2266 clib_error_t *sub_error;
2267 sub_error = vlib_call_all_main_loop_enter_functions (vm);
2269 clib_error_report (sub_error);
2272 switch (clib_setjmp (&vm->main_loop_exit, VLIB_MAIN_LOOP_EXIT_NONE))
2274 case VLIB_MAIN_LOOP_EXIT_NONE:
2275 vm->main_loop_exit_set = 1;
2278 case VLIB_MAIN_LOOP_EXIT_CLI:
2282 error = vm->main_loop_error;
2286 vlib_main_loop (vm);
2289 /* Call all exit functions. */
2291 clib_error_t *sub_error;
2292 sub_error = vlib_call_all_main_loop_exit_functions (vm);
2294 clib_error_report (sub_error);
2298 clib_error_report (error);
2304 vlib_pcap_dispatch_trace_configure (vlib_pcap_dispatch_trace_args_t * a)
2306 vlib_main_t *vm = vlib_get_main ();
2307 pcap_main_t *pm = &vm->dispatch_pcap_main;
2308 vlib_trace_main_t *tm;
2309 vlib_trace_node_t *tn;
2313 if (vm->dispatch_pcap_enable)
2317 (vm, "pcap dispatch capture enabled: %d of %d pkts...",
2318 pm->n_packets_captured, pm->n_packets_to_capture);
2319 vlib_cli_output (vm, "capture to file %s", pm->file_name);
2321 for (i = 0; i < vec_len (vm->dispatch_buffer_trace_nodes); i++)
2323 vlib_cli_output (vm,
2324 "Buffer trace of %d pkts from %U enabled...",
2325 a->buffer_traces_to_capture,
2326 format_vlib_node_name, vm,
2327 vm->dispatch_buffer_trace_nodes[i]);
2331 vlib_cli_output (vm, "pcap dispatch capture disabled");
2335 /* Consistency checks */
2337 /* Enable w/ capture already enabled not allowed */
2338 if (vm->dispatch_pcap_enable && a->enable)
2339 return -7; /* VNET_API_ERROR_INVALID_VALUE */
2341 /* Disable capture with capture already disabled, not interesting */
2342 if (vm->dispatch_pcap_enable == 0 && a->enable == 0)
2343 return -81; /* VNET_API_ERROR_VALUE_EXIST */
2345 /* Change number of packets to capture while capturing */
2346 if (vm->dispatch_pcap_enable && a->enable
2347 && (pm->n_packets_to_capture != a->packets_to_capture))
2348 return -8; /* VNET_API_ERROR_INVALID_VALUE_2 */
2350 /* Independent of enable/disable, to allow buffer trace multi nodes */
2351 if (a->buffer_trace_node_index != ~0)
2354 foreach_vlib_main ((
2356 tm = &this_vlib_main->trace_main;
2357 tm->verbose = 0; /* not sure this ever did anything... */
2358 vec_validate (tm->nodes, a->buffer_trace_node_index);
2359 tn = tm->nodes + a->buffer_trace_node_index;
2360 tn->limit += a->buffer_traces_to_capture;
2363 tm->filter_flag = FILTER_FLAG_POST_MORTEM;
2364 tm->filter_count = ~0;
2366 tm->trace_enable = 1;
2369 vec_add1 (vm->dispatch_buffer_trace_nodes, a->buffer_trace_node_index);
2374 /* Clean up from previous run, if any */
2375 vec_free (pm->file_name);
2376 vec_free (pm->pcap_data);
2377 memset (pm, 0, sizeof (*pm));
2379 vec_validate_aligned (vnet_trace_placeholder, 2048,
2380 CLIB_CACHE_LINE_BYTES);
2382 clib_spinlock_init (&(pm->lock));
2384 if (a->filename == 0)
2385 a->filename = format (0, "/tmp/dispatch.pcap%c", 0);
2387 pm->file_name = (char *) a->filename;
2388 pm->n_packets_captured = 0;
2389 pm->packet_type = PCAP_PACKET_TYPE_vpp;
2390 pm->n_packets_to_capture = a->packets_to_capture;
2391 vm->dispatch_pcap_postmortem = a->post_mortem;
2393 foreach_vlib_main (({ this_vlib_main->dispatch_pcap_enable = 1;}));
2399 foreach_vlib_main ((
2401 this_vlib_main->dispatch_pcap_enable = 0;
2402 this_vlib_main->dispatch_pcap_postmortem = 0;
2403 tm = &this_vlib_main->trace_main;
2404 tm->filter_flag = 0;
2405 tm->filter_count = 0;
2406 tm->trace_enable = 0;
2409 vec_reset_length (vm->dispatch_buffer_trace_nodes);
2410 if (pm->n_packets_captured)
2412 clib_error_t *error;
2413 pm->n_packets_to_capture = pm->n_packets_captured;
2414 vlib_cli_output (vm, "Write %d packets to %s, and stop capture...",
2415 pm->n_packets_captured, pm->file_name);
2416 error = pcap_write (pm);
2417 if (pm->flags & PCAP_MAIN_INIT_DONE)
2419 /* Report I/O errors... */
2422 clib_error_report (error);
2423 return -11; /* VNET_API_ERROR_SYSCALL_ERROR_1 */
2428 return -6; /* VNET_API_ERROR_NO_SUCH_ENTRY */
2434 static clib_error_t *
2435 dispatch_trace_command_fn (vlib_main_t * vm,
2436 unformat_input_t * input, vlib_cli_command_t * cmd)
2438 unformat_input_t _line_input, *line_input = &_line_input;
2439 vlib_pcap_dispatch_trace_args_t _a, *a = &_a;
2445 int post_mortem = 0;
2446 u32 node_index = ~0, buffer_traces_to_capture = 100;
2448 /* Get a line of input. */
2449 if (!unformat_user (input, unformat_line_input, line_input))
2452 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
2454 if (unformat (line_input, "on %=", &enable, 1))
2456 else if (unformat (line_input, "enable %=", &enable, 1))
2458 else if (unformat (line_input, "off %=", &enable, 0))
2460 else if (unformat (line_input, "disable %=", &enable, 0))
2462 else if (unformat (line_input, "max %d", &max))
2464 else if (unformat (line_input, "packets-to-capture %d", &max))
2466 else if (unformat (line_input, "file %U", unformat_vlib_tmpfile,
2469 else if (unformat (line_input, "status %=", &status, 1))
2471 else if (unformat (line_input, "buffer-trace %U %d",
2472 unformat_vlib_node, vm, &node_index,
2473 &buffer_traces_to_capture))
2475 else if (unformat (line_input, "post-mortem %=", &post_mortem, 1))
2479 return clib_error_return (0, "unknown input `%U'",
2480 format_unformat_error, line_input);
2484 unformat_free (line_input);
2486 /* no need for memset (a, 0, sizeof (*a)), set all fields here. */
2487 a->filename = filename;
2490 a->packets_to_capture = max;
2491 a->buffer_trace_node_index = node_index;
2492 a->buffer_traces_to_capture = buffer_traces_to_capture;
2493 a->post_mortem = post_mortem;
2495 rv = vlib_pcap_dispatch_trace_configure (a);
2503 return clib_error_return (0, "dispatch trace already enabled...");
2506 return clib_error_return (0, "dispatch trace already disabled...");
2509 return clib_error_return
2510 (0, "can't change number of records to capture while tracing...");
2513 return clib_error_return (0, "I/O writing trace capture...");
2516 return clib_error_return (0, "No packets captured...");
2519 vlib_cli_output (vm, "WARNING: trace configure returned %d", rv);
2526 * This command is used to start or stop pcap dispatch trace capture, or show
2527 * the capture status.
2529 * This command has the following optional parameters:
2531 * - <b>on|off</b> - Used to start or stop capture.
2533 * - <b>max <nn></b> - Depth of local buffer. Once '<em>nn</em>' number
2534 * of packets have been received, buffer is flushed to file. Once another
2535 * '<em>nn</em>' number of packets have been received, buffer is flushed
2536 * to file, overwriting previous write. If not entered, value defaults
2537 * to 100. Can only be updated if packet capture is off.
2539 * - <b>file <name></b> - Used to specify the output filename. The file will
2540 * be placed in the '<em>/tmp</em>' directory, so only the filename is
2541 * supported. Directory should not be entered. If file already exists, file
2542 * will be overwritten. If no filename is provided, '<em>/tmp/vpe.pcap</em>'
2543 * will be used. Can only be updated if packet capture is off.
2545 * - <b>status</b> - Displays the current status and configured attributes
2546 * associated with a packet capture. If packet capture is in progress,
2547 * '<em>status</em>' also will return the number of packets currently in
2548 * the local buffer. All additional attributes entered on command line
2549 * with '<em>status</em>' will be ignored and not applied.
2552 * Example of how to display the status of capture when off:
2553 * @cliexstart{pcap dispatch trace status}
2554 * max is 100, for any interface to file /tmp/vpe.pcap
2555 * pcap dispatch capture is off...
2557 * Example of how to start a dispatch trace capture:
2558 * @cliexstart{pcap dispatch trace on max 35 file dispatchTrace.pcap}
2559 * pcap dispatch capture on...
2561 * Example of how to start a dispatch trace capture with buffer tracing
2562 * @cliexstart{pcap dispatch trace on max 10000 file dispatchTrace.pcap buffer-trace dpdk-input 1000}
2563 * pcap dispatch capture on...
2565 * Example of how to display the status of a tx packet capture in progress:
2566 * @cliexstart{pcap tx trace status}
2567 * max is 35, dispatch trace to file /tmp/vppTest.pcap
2568 * pcap tx capture is on: 20 of 35 pkts...
2570 * Example of how to stop a tx packet capture:
2571 * @cliexstart{vppctl pcap dispatch trace off}
2572 * captured 21 pkts...
2573 * saved to /tmp/dispatchTrace.pcap...
2574 * Example of how to start a post-mortem dispatch trace:
2575 * pcap dispatch trace on max 20000 buffer-trace
2576 * dpdk-input 3000000000 post-mortem
2580 VLIB_CLI_COMMAND (pcap_dispatch_trace_command, static) = {
2581 .path = "pcap dispatch trace",
2583 "pcap dispatch trace [on|off] [max <nn>] [file <name>] [status]\n"
2584 " [buffer-trace <input-node-name> <nn>][post-mortem]",
2585 .function = dispatch_trace_command_fn,
2590 vlib_get_main_not_inline (void)
2592 return vlib_get_main ();
2596 vlib_get_elog_main_not_inline ()
2598 return &vlib_global_main.elog_main;
2602 * fd.io coding-style-patch-verification: ON
2605 * eval: (c-set-style "gnu")