api: vppapitrace JSON/API trace converter 03/21203/3
authorOle Troan <ot@cisco.com>
Tue, 30 Jul 2019 13:38:13 +0000 (15:38 +0200)
committerDave Barach <openvpp@barachs.net>
Mon, 12 Aug 2019 12:37:37 +0000 (12:37 +0000)
commitaf8075529fd660a487d1c2b8069da1b4a3714ec3
tree782606eebdf728caf6d6568f907f3d3c594a26a5
parent3d674e86b719a876be15f05b7ef9cb635717016e
api: vppapitrace JSON/API trace converter

  Usage: vppapitrace.py [-h] [--debug] [--apidir APIDIR] {convert,replay} ...

optional arguments:
  -h, --help        show this help message and exit
  --debug           enable debug mode
  --apidir APIDIR   Location of JSON API definitions

subcommands:
  valid subcommands

  {convert,replay}  additional help
    convert         Convert API trace to JSON or Python and back
    replay          Replay messages to running VPP instance

To convert an API trace file to JSON:
vppapitrace convert /tmp/api.trace trace.json

To convert an (edited) JSON file back to API trace for replay:
vppapitrace convert trace.json api-edited.trace

To generate a Python file that can be replayed:
vppapitrace convert /tmp/api.trace trace.py
vppapitrace convert trace.json trace.py

Replay it to a running VPP instance:
vppapitrace replay --socket /tmp/api.trace

In VPP that file can be replayed with:
vpp# api trace replay api-edited.trace

This patch also modifies the API binary trace format, to include the
message id to message name table.

Ticket: VPP-1733
Change-Id: Ie6441efb53c1c93c9f778f6ae9c1758bccc8dd87
Type: refactor
Signed-off-by: Ole Troan <ot@cisco.com>
(cherry picked from commit edfe2c0079a756f5fb1108037c39450e3521c8bd)
Signed-off-by: Andrew Yourtchenko <ayourtch@gmail.com>
MAINTAINERS
src/tools/vppapitrace/vppapitrace [new symlink]
src/tools/vppapitrace/vppapitrace.py [new file with mode: 0755]
src/vlibapi/api.h
src/vlibapi/api_shared.c
src/vlibmemory/socket_api.c
src/vlibmemory/vlib_api.c
src/vlibmemory/vlib_api_cli.c
src/vnet/ip/ip_api.c
src/vpp-api/python/vpp_papi/__init__.py
src/vpp-api/python/vpp_papi/vpp_papi.py