api: vppapitrace JSON/API trace converter 32/20932/12
authorOle Troan <ot@cisco.com>
Tue, 30 Jul 2019 13:38:13 +0000 (15:38 +0200)
committerDave Barach <openvpp@barachs.net>
Thu, 8 Aug 2019 23:01:18 +0000 (23:01 +0000)
commitedfe2c0079a756f5fb1108037c39450e3521c8bd
tree224db0f0abe2ef2610ac111674c3885867f830fe
parentc54235776c08ec1e10d80d8c91e6e45e2d2f6831
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.

Change-Id: Ie6441efb53c1c93c9f778f6ae9c1758bccc8dd87
Type: refactor
Signed-off-by: Ole Troan <ot@cisco.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