hwt(8) utility added

[br]

Summary

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.

Test Plan

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

[br]

Add '-t' argument allowing to specify thread index we want to read trace for.

[br]

Regenerate

[br]

ip range filtering added

[br]

suspend a single thread on mmap, not entire proc

[br]

Abstract tracing devices

[br]

usage() added

[br]

Add kernel-mode tracing support.

[br]

allow tracing multiple cpus in system mode

[br]

format flag added

[br]

Add -R (fs_root) flag.

[br]

decode multiple cpus at the same time

[br]

Regenerate

[br]

cleanup

[br]

Allow attaching to an existed proc;
Add support for libxo

[br]

obtain ETM IDR registers from sysctl. This is needed for Juno

[zachary.leaf_arm.com]

usr.sbin/hwt/hwt.c

60

What's hwt_libxo.h?

[br]

remove hwt_libxo.h as not needed

[br]

usr.sbin/hwt/hwt.c

60

That is not needed (Leftovers from libxo integration)

[br]

rebase for freebsd

[andrew]

usr.sbin/hwt/Makefile

2

#FreeBSD$

usr.sbin/hwt/hwt.c

172

This needs to be updated after making cpu_map a pointer.

203

Debug printf? And %#p isn't valid outsize of CheriBSD.

[br]

Intel PT support added by Bojan Novković