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ć

[br]

SPE added

[br]

Regenerate for Intel PT

[br]

Switch coresight to EL2 otherwise it does not trace CPU mode.

[br]

hwt_fmt added

[ziaee]

usr.sbin/hwt/hwt.8

1 ↗

(On Diff #155855)

No need to have the license in the text anymore, or use a dash at the beginning; check out style(9) in current or the licensing guide:

https://docs.freebsd.org/en/articles/license-guide/

30 ↗

(On Diff #155855)

No need to quote this, mdoc and style.mdoc both show it unquoted.

54 ↗

(On Diff #155855)

66 ↗

(On Diff #155855)

66 ↗

(On Diff #155855)

67 ↗

(On Diff #155855)

96 ↗

(On Diff #155855)

130 ↗

(On Diff #155855)

This also doesn't need to be quoted

[ziaee]

This is so cool! You can check for linter complaints with mandoc -Tlint here/is/the/manual.8

usr.sbin/hwt/hwt.8

25 ↗

(On Diff #155855)

No trailing zero, linter complains

26 ↗

(On Diff #155855)

Dt's are uppercase

56 ↗

(On Diff #155855)

58 ↗

(On Diff #155855)

91 ↗

(On Diff #155855)

96 ↗

(On Diff #155855)

Should we alphabetize these entries?

110 ↗

(On Diff #155855)

131 ↗

(On Diff #155855)

No Pp before Sh

133 ↗

(On Diff #155855)

Linter complains ^.^

137 ↗

(On Diff #155855)

[br]

• take run time linker path from ELF binary rather than from INTERP record
• address ziaee's comments