FD.io VPP  v19.04-6-g6f05f72
Vector Packet Processing
VLIB application library

clear

Summary/usage

Clear commands.

Declaration and implementation

Declaration: vlib_cli_clear_command (src/vlib/cli.c line 57)

clear errors

Summary/usage

Clear error counters.

Declaration and implementation

Declaration: cli_clear_error_counters (src/vlib/error.c line 323)

Implementation: clear_error_counters.

clear logging

Summary/usage

clear logging.

Declaration and implementation

Declaration: cli_clear_log (src/vlib/log.c line 409)

Implementation: clear_log.

clear node counters

Summary/usage

Clear node counters.

Declaration and implementation

Declaration: cli_clear_node_counters (src/vlib/error.c line 331)

Implementation: clear_error_counters.

clear runtime

Summary/usage

Clear packet processing runtime statistics.

Declaration and implementation

Declaration: clear_node_runtime_command (src/vlib/node_cli.c line 529)

Implementation: clear_node_runtime.

clear trace

Summary/usage

Clear trace buffer and free memory.

Declaration and implementation

Declaration: clear_trace_cli (src/vlib/trace.c line 519)

Implementation: cli_clear_trace_buffer.

elog trace

Summary/usage

elog trace [api][cli][barrier][dispatch]n[circuit-node <name> e.g. ethernet-input][disable].

Description

Control event logging of api, cli, and thread barrier events With no arguments, displays the current trace status. Name the event groups you wish to trace or stop tracing.

Example usage
elog trace api cli barrier
elog trace api cli barrier disable
elog trace dispatch
elog trace circuit-node ethernet-input
elog trace
vpp# elog trace [api][cli][barrier][disable]

Declaration and implementation

Declaration: elog_trace_command (src/vlib/cli.c line 1561)

Implementation: elog_trace_command_fn.

event-logger clear

Summary/usage

Clear the event log.

Declaration and implementation

Declaration: elog_clear_cli (src/vlib/main.c line 710)

Implementation: vlib_cli_elog_clear.

event-logger resize

Summary/usage

event-logger resize <nnn>.

Declaration and implementation

Declaration: elog_resize_cli (src/vlib/main.c line 844)

Implementation: elog_resize.

event-logger restart

Summary/usage

Restart the event-logger.

Declaration and implementation

Declaration: elog_restart_cli (src/vlib/main.c line 814)

Implementation: elog_restart.

event-logger save

Summary/usage

event-logger save <filename> (saves log in /tmp/<filename>).

Declaration and implementation

Declaration: elog_save_cli (src/vlib/main.c line 774)

Implementation: elog_save_buffer.

event-logger stop

Summary/usage

Stop the event-logger.

Declaration and implementation

Declaration: elog_stop_cli (src/vlib/main.c line 794)

Implementation: elog_stop.

memory-trace

Summary/usage

on|off [api-segment] Enable/disable memory allocation trace.

Declaration and implementation

Declaration: enable_disable_memory_trace_command (src/vlib/cli.c line 921)

Implementation: enable_disable_memory_trace.

pcap dispatch trace

Summary/usage

pcap dispatch trace [on|off] [max <nn>] [file <name>] [status]n              [buffer-trace <input-node-name> <nn>].

Description

This command is used to start or stop pcap dispatch trace capture, or show the capture status.

This command has the following optional parameters:

  • on|off - Used to start or stop capture.
  • max <nn> - Depth of local buffer. Once 'nn' number of packets have been received, buffer is flushed to file. Once another 'nn' number of packets have been received, buffer is flushed to file, overwriting previous write. If not entered, value defaults to 100. Can only be updated if packet capture is off.
  • file <name> - Used to specify the output filename. The file will be placed in the '/tmp' directory, so only the filename is supported. Directory should not be entered. If file already exists, file will be overwritten. If no filename is provided, '/tmp/vpe.pcap' will be used. Can only be updated if packet capture is off.
  • status - Displays the current status and configured attributes associated with a packet capture. If packet capture is in progress, 'status' also will return the number of packets currently in the local buffer. All additional attributes entered on command line with 'status' will be ignored and not applied.
Example usage
Example of how to display the status of capture when off:
vpp# pcap dispatch trace status
max is 100, for any interface to file /tmp/vpe.pcap
pcap dispatch capture is off...
Example of how to start a dispatch trace capture:
vpp# pcap dispatch trace on max 35 file dispatchTrace.pcap
pcap dispatch capture on...
Example of how to start a dispatch trace capture with buffer tracing
vpp# pcap dispatch trace on max 10000 file dispatchTrace.pcap buffer-trace dpdk-input 1000
pcap dispatch capture on...
Example of how to display the status of a tx packet capture in progress:
vpp# pcap tx trace status
max is 35, dispatch trace to file /tmp/vppTest.pcap
pcap tx capture is on: 20 of 35 pkts...
Example of how to stop a tx packet capture:
vpp# vppctl pcap dispatch trace off
captured 21 pkts...
saved to /tmp/dispatchTrace.pcap...

Declaration and implementation

Declaration: pcap_dispatch_trace_command (src/vlib/main.c line 2345)

Implementation: pcap_dispatch_trace_command_fn.

restart

Summary/usage

restart process.

Declaration and implementation

Declaration: restart_cmd (src/vlib/cli.c line 1020)

Implementation: restart_cmd_fn.

set

Summary/usage

Set commands.

Declaration and implementation

Declaration: vlib_cli_set_command (src/vlib/cli.c line 65)

set logging class

Summary/usage

set loggging class <class> [rate-limit <int>] [level <level>] [syslog-level <level>].

Declaration and implementation

Declaration: cli_set_log (src/vlib/log.c line 543)

Implementation: set_log_class.

set logging size

Summary/usage

set logging size <int>.

Declaration and implementation

Declaration: cli_set_log_size (src/vlib/log.c line 613)

Implementation: set_log_size.

set logging unthrottle-time

Summary/usage

set logging unthrottle-time <int>.

Declaration and implementation

Declaration: cli_set_log_params (src/vlib/log.c line 577)

Implementation: set_log_unth_time.

set node function

Summary/usage

set node function <node-name> <variant-name>.

Declaration and implementation

Declaration: set_node_fn_command (src/vlib/node_cli.c line 739)

Implementation: set_node_fn.

show

Summary/usage

Show commands.

Declaration and implementation

Declaration: vlib_cli_show_command (src/vlib/cli.c line 49)

show buffers

Summary/usage

Show packet buffer allocation.

Declaration and implementation

Declaration: show_buffers_command (src/vlib/buffer.c line 627)

Implementation: show_buffers.

show cli

Summary/usage

Show cli commands.

Declaration and implementation

Declaration: show_cli_command (src/vlib/cli.c line 1455)

Implementation: show_cli_cmd_fn.

show clock

Summary/usage

show clock.

Declaration and implementation

Declaration: f_command (src/vlib/threads.c line 1873)

Implementation: show_clock_command_fn.

show cpu

Summary/usage

Show cpu information.

Description

Displays various information about the CPU.

Example usage
vpp# show cpu
Model name:               Intel(R) Xeon(R) CPU E5-2667 v4 @ 3.20GHz
Microarchitecture:        Broadwell (Broadwell-EP/EX)
Flags:                    sse3 ssse3 sse41 sse42 avx avx2 aes
Base Frequency:           3.20 GHz

Declaration and implementation

Declaration: show_cpu_command (src/vlib/cli.c line 875)

Implementation: show_cpu.

show errors

Summary/usage

Show error counts.

Declaration and implementation

Declaration: vlib_cli_show_errors (src/vlib/error.c line 289)

Implementation: show_errors.

show event-logger

Summary/usage

Show event logger info.

Declaration and implementation

Declaration: elog_show_cli (src/vlib/main.c line 903)

Implementation: elog_show_buffer.

show frame-queue

Summary/usage

show frame-queue trace.

Declaration and implementation

Declaration: cmd_show_frame_queue_trace (src/vlib/threads_cli.c line 366)

Implementation: show_frame_queue_trace.

show frame-queue histogram

Summary/usage

show frame-queue histogram.

Declaration and implementation

Declaration: cmd_show_frame_queue_histogram (src/vlib/threads_cli.c line 374)

Implementation: show_frame_queue_histogram.

show logging

Summary/usage

show logging.

Declaration and implementation

Declaration: cli_show_log (src/vlib/log.c line 330)

Implementation: show_log.

show logging configuration

Summary/usage

show logging configuration.

Declaration and implementation

Declaration: cli_show_log_config (src/vlib/log.c line 378)

Implementation: show_log_config.

show memory

Summary/usage

[verbose | api-segment] Show current memory usage.

Declaration and implementation

Declaration: show_memory_usage_command (src/vlib/cli.c line 842)

Implementation: show_memory_usage.

show node

Summary/usage

show node [index] <node-name | node-index>.

Declaration and implementation

Declaration: show_node_command (src/vlib/node_cli.c line 669)

Implementation: show_node.

show node counters

Summary/usage

Show node counters.

Declaration and implementation

Declaration: cli_show_node_counters (src/vlib/error.c line 297)

Implementation: show_errors.

show physmem

Summary/usage

show physmem [verbose | detail | map].

Declaration and implementation

Declaration: show_physmem_command (src/vlib/physmem.c line 160)

Implementation: show_physmem.

show punt client

Summary/usage

show client[s] registered with the punt infra.

Declaration and implementation

Declaration: punt_client_show_command (src/vlib/punt.c line 512)

Implementation: punt_client_show.

show punt db

Summary/usage

show the punt DB.

Declaration and implementation

Declaration: punt_db_show_command (src/vlib/punt.c line 578)

Implementation: punt_db_show.

show punt reasons

Summary/usage

show all punt reasons.

Declaration and implementation

Declaration: punt_reason_show_command (src/vlib/punt.c line 535)

Implementation: punt_reason_show.

show punt stats

Summary/usage

show the punt stats.

Declaration and implementation

Declaration: punt_stats_show_command (src/vlib/punt.c line 605)

Implementation: punt_stats_show.

show runtime

Summary/usage

Show packet processing runtime.

Declaration and implementation

Declaration: show_node_runtime_command (src/vlib/node_cli.c line 476)

Implementation: show_node_runtime.

show threads

Summary/usage

Show threads.

Declaration and implementation

Declaration: show_threads_command (src/vlib/threads_cli.c line 88)

Implementation: show_threads_fn.

show trace

Summary/usage

Show trace buffer [max COUNT].

Declaration and implementation

Declaration: show_trace_cli (src/vlib/trace.c line 347)

Implementation: cli_show_trace_buffer.

show vlib frame-allocation

Summary/usage

Show node dispatch frame statistics.

Declaration and implementation

Declaration: show_frame_stats_cli (src/vlib/main.c line 271)

Implementation: show_frame_stats.

show vlib graph

Summary/usage

Show packet processing node graph.

Declaration and implementation

Declaration: show_node_graph_command (src/vlib/node_cli.c line 87)

Implementation: show_node_graph.

show vlib graphviz

Summary/usage

Dump packet processing node graph as a graphviz dotfile.

Declaration and implementation

Declaration: show_node_graphviz_command (src/vlib/node_cli.c line 162)

Implementation: show_node_graphviz.

test

Summary/usage

Test commands.

Declaration and implementation

Declaration: vlib_cli_test_command (src/vlib/cli.c line 73)

test frame-queue nelts

Summary/usage

test frame-queue nelts (4,8,16,32).

Declaration and implementation

Declaration: cmd_test_frame_queue_nelts (src/vlib/threads_cli.c line 449)

Implementation: test_frame_queue_nelts.

test frame-queue threshold

Summary/usage

test frame-queue threshold N (0=no limit).

Declaration and implementation

Declaration: cmd_test_frame_queue_threshold (src/vlib/threads_cli.c line 528)

Implementation: test_frame_queue_threshold.

test heap-validate

Summary/usage

<on/off/now> validate heap on future allocs/frees or right now.

Declaration and implementation

Declaration: cmd_test_heap_validate (src/vlib/cli.c line 987)

Implementation: test_heap_validate.

test log

Summary/usage

test log <level> <class> <subclass> <message>.

Declaration and implementation

Declaration: cli_test_log (src/vlib/log.c line 692)

Implementation: test_log_class_subclass.

test sleep

Summary/usage

Sleep for 10 seconds.

Declaration and implementation

Declaration: ping_command (src/vlib/cli.c line 1052)

Implementation: sleep_ten_seconds.

trace

Summary/usage

Packet tracer commands.

Declaration and implementation

Declaration: trace_cli_command (src/vlib/trace.c line 172)

trace add

Summary/usage

Trace given number of packets.

Declaration and implementation

Declaration: add_trace_cli (src/vlib/trace.c line 405)

Implementation: cli_add_trace_buffer.

trace filter

Summary/usage

filter trace output - include NODE COUNT | exclude NODE COUNT | none.

Declaration and implementation

Declaration: filter_trace_cli (src/vlib/trace.c line 503)

Implementation: cli_filter_trace.

trace frame-queue

Summary/usage

trace frame-queue (on|off).

Declaration and implementation

Declaration: cmd_trace_frame_queue (src/vlib/threads_cli.c line 184)

Implementation: trace_frame_queue.