.. _clicmd_src_vlib:
===============================================================
VLIB application library
===============================================================
clear
-------------------------------------------------------------------------
.. code-block:: console
Clear commands
Declaration: ``vlib_cli_clear_command`` `src/vlib/cli.c line 67 <https://github.com/FDio/vpp/blob/master//src/vlib/cli.c#L67>`_
clear errors
-------------------------------------------------------------------------
.. code-block:: console
Clear error counters
Declaration: ``cli_clear_error_counters`` `src/vlib/error.c line 399 <https://github.com/FDio/vpp/blob/master//src/vlib/error.c#L399>`_
Implementation: ``clear_error_counters``
clear logging
-------------------------------------------------------------------------
.. code-block:: console
clear logging
Declaration: ``cli_clear_log`` `src/vlib/log.c line 505 <https://github.com/FDio/vpp/blob/master//src/vlib/log.c#L505>`_
Implementation: ``clear_log``
clear node counters
-------------------------------------------------------------------------
.. code-block:: console
Clear node counters
Declaration: ``cli_clear_node_counters`` `src/vlib/error.c line 407 <https://github.com/FDio/vpp/blob/master//src/vlib/error.c#L407>`_
Implementation: ``clear_error_counters``
clear runtime
-------------------------------------------------------------------------
.. code-block:: console
Clear packet processing runtime statistics
Declaration: ``clear_node_runtime_command`` `src/vlib/node_cli.c line 689 <https://github.com/FDio/vpp/blob/master//src/vlib/node_cli.c#L689>`_
Implementation: ``clear_node_runtime``
clear trace
-------------------------------------------------------------------------
.. code-block:: console
Clear trace buffer and free memory
Declaration: ``clear_trace_cli`` `src/vlib/trace.c line 602 <https://github.com/FDio/vpp/blob/master//src/vlib/trace.c#L602>`_
Implementation: ``cli_clear_trace_buffer``
event-logger clear
-------------------------------------------------------------------------
.. code-block:: console
Clear the event log
Declaration: ``elog_clear_cli`` `src/vlib/main.c line 638 <https://github.com/FDio/vpp/blob/master//src/vlib/main.c#L638>`_
Implementation: ``vlib_cli_elog_clear``
event-logger resize
-------------------------------------------------------------------------
.. code-block:: console
event-logger resize <nnn>
Declaration: ``elog_resize_cli`` `src/vlib/main.c line 763 <https://github.com/FDio/vpp/blob/master//src/vlib/main.c#L763>`_
Implementation: ``elog_resize_command_fn``
event-logger restart
-------------------------------------------------------------------------
.. code-block:: console
Restart the event-logger
Declaration: ``elog_restart_cli`` `src/vlib/main.c line 733 <https://github.com/FDio/vpp/blob/master//src/vlib/main.c#L733>`_
Implementation: ``elog_restart``
event-logger save
-------------------------------------------------------------------------
.. code-block:: console
event-logger save <filename> (saves log in /tmp/<filename>)
Declaration: ``elog_save_cli`` `src/vlib/main.c line 693 <https://github.com/FDio/vpp/blob/master//src/vlib/main.c#L693>`_
Implementation: ``elog_save_buffer``
event-logger stop
-------------------------------------------------------------------------
.. code-block:: console
Stop the event-logger
Declaration: ``elog_stop_cli`` `src/vlib/main.c line 713 <https://github.com/FDio/vpp/blob/master//src/vlib/main.c#L713>`_
Implementation: ``elog_stop``
event-logger trace
-------------------------------------------------------------------------
.. code-block:: console
event-logger trace [api][cli][barrier][dispatch]
[circuit-node <name> e.g. ethernet-input][disable]
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.
.. code-block:: console
event-logger trace api cli barrier
event-logger trace api cli barrier disable
event-logger trace dispatch
event-logger trace circuit-node ethernet-input
.. code-block:: console
event-logger trace [api][cli][barrier][disable]
Declaration: ``event_logger_trace_command`` `src/vlib/cli.c line 1653 <https://github.com/FDio/vpp/blob/master//src/vlib/cli.c#L1653>`_
Implementation: ``event_logger_trace_command_fn``
memory-trace
-------------------------------------------------------------------------
.. code-block:: console
memory-trace on|off [api-segment][stats-segment][main-heap]
[numa-heap <numa-id>]
Declaration: ``enable_disable_memory_trace_command`` `src/vlib/cli.c line 1129 <https://github.com/FDio/vpp/blob/master//src/vlib/cli.c#L1129>`_
Implementation: ``enable_disable_memory_trace``
restart
-------------------------------------------------------------------------
.. code-block:: console
restart process
Declaration: ``restart_cmd`` `src/vlib/cli.c line 1164 <https://github.com/FDio/vpp/blob/master//src/vlib/cli.c#L1164>`_
Implementation: ``restart_cmd_fn``
set
-------------------------------------------------------------------------
.. code-block:: console
Set commands
Declaration: ``vlib_cli_set_command`` `src/vlib/cli.c line 75 <https://github.com/FDio/vpp/blob/master//src/vlib/cli.c#L75>`_
set clock adjust
-------------------------------------------------------------------------
.. code-block:: console
set clock adjust <nn>
Declaration: ``vlib_time_virtual_command`` `src/vlib/time.c line 80 <https://github.com/FDio/vpp/blob/master//src/vlib/time.c#L80>`_
Implementation: ``vlib_time_virtual_adjust_command_fn``
set logging class
-------------------------------------------------------------------------
.. code-block:: console
set logging class <class> [rate-limit <int>] [level <level>] [syslog-level <level>]
Declaration: ``cli_set_log`` `src/vlib/log.c line 639 <https://github.com/FDio/vpp/blob/master//src/vlib/log.c#L639>`_
Implementation: ``set_log_class``
set logging size
-------------------------------------------------------------------------
.. code-block:: console
set logging size <int>
Declaration: ``cli_set_log_size`` `src/vlib/log.c line 709 <https://github.com/FDio/vpp/blob/master//src/vlib/log.c#L709>`_
Implementation: ``set_log_size``
set logging unthrottle-time
-------------------------------------------------------------------------
.. code-block:: console
set logging unthrottle-time <int>
Declaration: ``cli_set_log_params`` `src/vlib/log.c line 673 <https://github.com/FDio/vpp/blob/master//src/vlib/log.c#L673>`_
Implementation: ``set_log_unth_time``
set node function
-------------------------------------------------------------------------
.. code-block:: console
set node function <node-name> <variant-name>
Declaration: ``set_node_fn_command`` `src/vlib/node_cli.c line 912 <https://github.com/FDio/vpp/blob/master//src/vlib/node_cli.c#L912>`_
Implementation: ``set_node_fn``
show
-------------------------------------------------------------------------
.. code-block:: console
Show commands
Declaration: ``vlib_cli_show_command`` `src/vlib/cli.c line 59 <https://github.com/FDio/vpp/blob/master//src/vlib/cli.c#L59>`_
show buffers
-------------------------------------------------------------------------
.. code-block:: console
Show packet buffer allocation
Declaration: ``show_buffers_command`` `src/vlib/buffer.c line 631 <https://github.com/FDio/vpp/blob/master//src/vlib/buffer.c#L631>`_
Implementation: ``show_buffers``
show cli
-------------------------------------------------------------------------
.. code-block:: console
show cli [mp-safe][not-mp-safe][hit][clear-hit]
Displays debug cli command information
.. code-block:: console
show cli [mp-safe][not-mp-safe][hit][clear-hit]
"show cli" displays the entire debug cli:
abf attach
abf policy
adjacency counters
api trace
app ns
bfd key del
... and so on ...
"show cli mp-safe" displays mp-safe debug CLI commands:
abf policy
binary-api
create vhost-user
exec
ip container
ip mroute
ip probe-neighbor
ip route
ip scan-neighbor
ip table
ip6 table
"show cli not-mp-safe" displays debug CLI commands
which cause worker thread barrier synchronization
"show cli hit" displays commands which have been executed. Qualify
as desired with "mp-safe" or "not-mp-safe".
"show cli clear-hit" clears the per-command hit counters.
Declaration: ``show_cli_command`` `src/vlib/cli.c line 1870 <https://github.com/FDio/vpp/blob/master//src/vlib/cli.c#L1870>`_
Implementation: ``show_cli_command_fn``
show clock
-------------------------------------------------------------------------
.. code-block:: console
show clock
Declaration: ``f_command`` `src/vlib/threads.c line 1730 <https://github.com/FDio/vpp/blob/master//src/vlib/threads.c#L1730>`_
Implementation: ``show_clock_command_fn``
show cpu
-------------------------------------------------------------------------
.. code-block:: console
Show cpu information
Displays various information about the CPU.
.. code-block:: console
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: ``show_cpu_command`` `src/vlib/cli.c line 1015 <https://github.com/FDio/vpp/blob/master//src/vlib/cli.c#L1015>`_
Implementation: ``show_cpu``
show errors
-------------------------------------------------------------------------
.. code-block:: console
Show error counts
Declaration: ``vlib_cli_show_errors`` `src/vlib/error.c line 366 <https://github.com/FDio/vpp/blob/master//src/vlib/error.c#L366>`_
Implementation: ``show_errors``
show event-logger
-------------------------------------------------------------------------
.. code-block:: console
Show event logger info
Declaration: ``elog_show_cli`` `src/vlib/main.c line 822 <https://github.com/FDio/vpp/blob/master//src/vlib/main.c#L822>`_
Implementation: ``elog_show_buffer``
show frame-queue
-------------------------------------------------------------------------
.. code-block:: console
show frame-queue trace
Declaration: ``cmd_show_frame_queue_trace`` `src/vlib/threads_cli.c line 367 <https://github.com/FDio/vpp/blob/master//src/vlib/threads_cli.c#L367>`_
Implementation: ``show_frame_queue_trace``
show frame-queue histogram
-------------------------------------------------------------------------
.. code-block:: console
show frame-queue histogram
Declaration: ``cmd_show_frame_queue_histogram`` `src/vlib/threads_cli.c line 375 <https://github.com/FDio/vpp/blob/master//src/vlib/threads_cli.c#L375>`_
Implementation: ``show_frame_queue_histogram``
show logging
-------------------------------------------------------------------------
.. code-block:: console
show logging
Declaration: ``cli_show_log`` `src/vlib/log.c line 426 <https://github.com/FDio/vpp/blob/master//src/vlib/log.c#L426>`_
Implementation: ``show_log``
show logging configuration
-------------------------------------------------------------------------
.. code-block:: console
show logging configuration
Declaration: ``cli_show_log_config`` `src/vlib/log.c line 474 <https://github.com/FDio/vpp/blob/master//src/vlib/log.c#L474>`_
Implementation: ``show_log_config``
show memory
-------------------------------------------------------------------------
.. code-block:: console
show memory [api-segment][stats-segment][verbose]
[numa-heaps][map]
Declaration: ``show_memory_usage_command`` `src/vlib/cli.c line 981 <https://github.com/FDio/vpp/blob/master//src/vlib/cli.c#L981>`_
Implementation: ``show_memory_usage``
show node
-------------------------------------------------------------------------
.. code-block:: console
show node [index] <node-name | node-index>
Declaration: ``show_node_command`` `src/vlib/node_cli.c line 859 <https://github.com/FDio/vpp/blob/master//src/vlib/node_cli.c#L859>`_
Implementation: ``show_node``
show node counters
-------------------------------------------------------------------------
.. code-block:: console
Show node counters
Declaration: ``cli_show_node_counters`` `src/vlib/error.c line 374 <https://github.com/FDio/vpp/blob/master//src/vlib/error.c#L374>`_
Implementation: ``show_errors``
show physmem
-------------------------------------------------------------------------
.. code-block:: console
show physmem [verbose | detail | map]
Declaration: ``show_physmem_command`` `src/vlib/physmem.c line 164 <https://github.com/FDio/vpp/blob/master//src/vlib/physmem.c#L164>`_
Implementation: ``show_physmem``
show punt client
-------------------------------------------------------------------------
.. code-block:: console
show client[s] registered with the punt infra
Declaration: ``punt_client_show_command`` `src/vlib/punt.c line 610 <https://github.com/FDio/vpp/blob/master//src/vlib/punt.c#L610>`_
Implementation: ``punt_client_show``
show punt db
-------------------------------------------------------------------------
.. code-block:: console
show the punt DB
Declaration: ``punt_db_show_command`` `src/vlib/punt.c line 676 <https://github.com/FDio/vpp/blob/master//src/vlib/punt.c#L676>`_
Implementation: ``punt_db_show``
show punt reasons
-------------------------------------------------------------------------
.. code-block:: console
show all punt reasons
Declaration: ``punt_reason_show_command`` `src/vlib/punt.c line 633 <https://github.com/FDio/vpp/blob/master//src/vlib/punt.c#L633>`_
Implementation: ``punt_reason_show``
show punt stats
-------------------------------------------------------------------------
.. code-block:: console
show the punt stats
Declaration: ``punt_stats_show_command`` `src/vlib/punt.c line 703 <https://github.com/FDio/vpp/blob/master//src/vlib/punt.c#L703>`_
Implementation: ``punt_stats_show``
show runtime
-------------------------------------------------------------------------
.. code-block:: console
Show packet processing runtime
Declaration: ``show_node_runtime_command`` `src/vlib/node_cli.c line 634 <https://github.com/FDio/vpp/blob/master//src/vlib/node_cli.c#L634>`_
Implementation: ``show_node_runtime``
show threads
-------------------------------------------------------------------------
.. code-block:: console
Show threads
Declaration: ``show_threads_command`` `src/vlib/threads_cli.c line 89 <https://github.com/FDio/vpp/blob/master//src/vlib/threads_cli.c#L89>`_
Implementation: ``show_threads_fn``
show trace
-------------------------------------------------------------------------
.. code-block:: console
Show trace buffer [max COUNT]
Declaration: ``show_trace_cli`` `src/vlib/trace.c line 361 <https://github.com/FDio/vpp/blob/master//src/vlib/trace.c#L361>`_
Implementation: ``cli_show_trace_buffer``
show vlib frame-allocation
-------------------------------------------------------------------------
.. code-block:: console
Show node dispatch frame statistics
Declaration: ``show_frame_stats_cli`` `src/vlib/main.c line 244 <https://github.com/FDio/vpp/blob/master//src/vlib/main.c#L244>`_
Implementation: ``show_frame_stats``
show vlib graph
-------------------------------------------------------------------------
.. code-block:: console
Show packet processing node graph
Declaration: ``show_node_graph_command`` `src/vlib/node_cli.c line 89 <https://github.com/FDio/vpp/blob/master//src/vlib/node_cli.c#L89>`_
Implementation: ``show_node_graph``
show vlib graphviz
-------------------------------------------------------------------------
.. code-block:: console
Dump packet processing node graph as a graphviz dotfile
Dump dot files data to draw a graph of all the nodes.
If the argument 'filter' is provided, only the active nodes (since the last
"clear run" command) are selected and they are scaled and colored according
to their utilization. You can choose to filter nodes that are called,
nodes that receive vectors or both (default).
The 'file' option allows to save data in a temp file.
.. code-block:: console
show vlib graphviz
show vlib graphviz filter file tmpfile
show vlib graphviz filter calls file tmpfile
.. code-block:: console
show vlib graphviz [filter][calls][vectors][file <filename>]
Declaration: ``show_node_graphviz_command`` `src/vlib/node_cli.c line 328 <https://github.com/FDio/vpp/blob/master//src/vlib/node_cli.c#L328>`_
Implementation: ``show_node_graphviz``
suspend
-------------------------------------------------------------------------
.. code-block:: console
suspend debug CLI for 30ms
Declaration: ``suspend_command`` `src/vlib/cli.c line 1671 <https://github.com/FDio/vpp/blob/master//src/vlib/cli.c#L1671>`_
Implementation: ``suspend_command_fn``
test
-------------------------------------------------------------------------
.. code-block:: console
Test commands
Declaration: ``vlib_cli_test_command`` `src/vlib/cli.c line 83 <https://github.com/FDio/vpp/blob/master//src/vlib/cli.c#L83>`_
test frame-queue nelts
-------------------------------------------------------------------------
.. code-block:: console
test frame-queue nelts (4,8,16,32)
Declaration: ``cmd_test_frame_queue_nelts`` `src/vlib/threads_cli.c line 450 <https://github.com/FDio/vpp/blob/master//src/vlib/threads_cli.c#L450>`_
Implementation: ``test_frame_queue_nelts``
test frame-queue threshold
-------------------------------------------------------------------------
.. code-block:: console
test frame-queue threshold N (0=no limit)
Declaration: ``cmd_test_frame_queue_threshold`` `src/vlib/threads_cli.c line 529 <https://github.com/FDio/vpp/blob/master//src/vlib/threads_cli.c#L529>`_
Implementation: ``test_frame_queue_threshold``
test log
-------------------------------------------------------------------------
.. code-block:: console
test log <level> <class> <subclass> <message>
Declaration: ``cli_test_log`` `src/vlib/log.c line 788 <https://github.com/FDio/vpp/blob/master//src/vlib/log.c#L788>`_
Implementation: ``test_log_class_subclass``
test sleep
-------------------------------------------------------------------------
.. code-block:: console
Sleep for 10 seconds
Declaration: ``ping_command`` `src/vlib/cli.c line 1196 <https://github.com/FDio/vpp/blob/master//src/vlib/cli.c#L1196>`_
Implementation: ``sleep_ten_seconds``
trace
-------------------------------------------------------------------------
.. code-block:: console
Packet tracer commands
Declaration: ``trace_cli_command`` `src/vlib/trace.c line 177 <https://github.com/FDio/vpp/blob/master//src/vlib/trace.c#L177>`_
trace add
-------------------------------------------------------------------------
.. code-block:: console
trace add <input-graph-node> <add'l-pkts-for-node-> [filter] [verbose]
Declaration: ``add_trace_cli`` `src/vlib/trace.c line 482 <https://github.com/FDio/vpp/blob/master//src/vlib/trace.c#L482>`_
Implementation: ``cli_add_trace_buffer``
trace filter
-------------------------------------------------------------------------
.. code-block:: console
trace filter none | [include|exclude] NODE COUNT
Declaration: ``filter_trace_cli`` `src/vlib/trace.c line 586 <https://github.com/FDio/vpp/blob/master//src/vlib/trace.c#L586>`_
Implementation: ``cli_filter_trace``
trace frame-queue
-------------------------------------------------------------------------
.. code-block:: console
trace frame-queue (on|off)
Declaration: ``cmd_trace_frame_queue`` `src/vlib/threads_cli.c line 185 <https://github.com/FDio/vpp/blob/master//src/vlib/threads_cli.c#L185>`_
Implementation: ``trace_frame_queue``