This instrumentation tool is a part of hwt(4) framework. It controls tracing units.

hwt(8) tool takes a path to an executable as an argument, creates kernel tracing context, then runs the application with tracing unit enabled.
Once some traces collected, hwt(8) decodes data using OpenCSD framework (on arm64) and prints the trace results in human readable format to standard output.

Tested with ARM Coresight on ARM Morello board.

Example usage, thread mode.

1. In this scenario we will be tracing all the threads of "test" executable, but decode only thread 0.

sudo ./hwt -t 0 ./test/test

2. In this scenario we will be tracing main() fuction of test executable only.

sudo ./hwt -t 0 ./test/test -i test -f main

3. In this scenario we will be tracing strlen() function of test executable only.

sudo ./hwt -t 0 ./test/test -i libc.so.7 -f strlen

CPU mode. In this scenario tracing context collects information for CPUs number 1 and 3 */

sudo ./hwt -s 3,1 -i kernel -f cpu_switch