Details

Reviewers

andrew
zachary.leaf_arm.com

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.

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

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

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

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

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

Diff Detail

Lint

Lint Skipped

Unit

Tests Skipped

Event Timeline

br created this revision.Jun 23 2023, 6:56 PM

Herald added a reviewer: andrew. · View Herald TranscriptJun 23 2023, 6:56 PM

Herald added a subscriber: emaste. · View Herald Transcript

br requested review of this revision.Jun 23 2023, 6:56 PM

br added a parent revision: D40477: HWT: ARM CoreSight support.

br added a parent revision: D40466: Hardware Trace (HWT) framework.Jun 23 2023, 7:08 PM

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

Regenerate

zachary.leaf_arm.com added a subscriber: zachary.leaf_arm.com.Jul 4 2023, 9:54 AM

ip range filtering added

suspend a single thread on mmap, not entire proc

Abstract tracing devices

usage() added

Add kernel-mode tracing support.

allow tracing multiple cpus in system mode

format flag added

Add -R (fs_root) flag.

decode multiple cpus at the same time

Herald added a reviewer: bdrewery. · View Herald TranscriptAug 3 2023, 6:11 PM

Herald added a reviewer: bhyve. · View Herald Transcript

Herald added subscribers: jrtc27, dab, bcran and 2 others. · View Herald Transcript

Regenerate

br removed reviewers: andrew, bdrewery, bhyve.Aug 3 2023, 6:34 PM

br removed subscribers: delphij, rgrimes, bcran and 2 others.

cleanup

Herald added a reviewer: andrew. · View Herald TranscriptAug 8 2023, 12:35 PM

br edited the test plan for this revision. (Show Details)Aug 8 2023, 1:21 PM

Allow attaching to an existed proc;
Add support for libxo

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

zachary.leaf_arm.com added inline comments.Aug 21 2023, 11:18 AM

usr.sbin/hwt/hwt.c
59 ↗	(On Diff #126228)	What's `hwt_libxo.h`?

remove hwt_libxo.h as not needed

br added inline comments.Aug 21 2023, 11:48 AM

usr.sbin/hwt/hwt.c
59 ↗	(On Diff #126228)	That is not needed (Leftovers from libxo integration)

rebase for freebsd

andrew added inline comments.Sep 28 2023, 1:21 PM

usr.sbin/hwt/Makefile
1 ↗	(On Diff #127773)	`#FreeBSD$`
usr.sbin/hwt/hwt.c
171 ↗	(On Diff #127773)	This needs to be updated after making cpu_map a pointer.
202 ↗	(On Diff #127773)	Debug `printf`? And `%#p` isn't valid outsize of CheriBSD.

mhorne mentioned this in D35709: fix pmcstat .Oct 10 2023, 5:24 PM

Intel PT support added by Bojan Novković

zachary.leaf_arm.com added a reviewer: zachary.leaf_arm.com.Mar 14 2024, 5:25 PM

SPE added

Regenerate for Intel PT

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

hwt(8) utility addedNeeds ReviewPublicActions

Details

Diff Detail

Event Timeline

Revision ContentsChangeset List

Diff 125533

sys/conf/files

sys/conf/options

sys/dev/hwt/hwt.c

sys/dev/hwt/hwt_backend.h

sys/dev/hwt/hwt_backend.c

sys/dev/hwt/hwt_config.h

sys/dev/hwt/hwt_config.c

sys/dev/hwt/hwt_context.h

sys/dev/hwt/hwt_context.c

sys/dev/hwt/hwt_contexthash.h

sys/dev/hwt/hwt_contexthash.c

sys/dev/hwt/hwt_cpu.h

sys/dev/hwt/hwt_cpu.c

sys/dev/hwt/hwt_hook.h

sys/dev/hwt/hwt_hook.c

sys/dev/hwt/hwt_ioctl.h

sys/dev/hwt/hwt_ioctl.c

sys/dev/hwt/hwt_owner.h

sys/dev/hwt/hwt_owner.c

sys/dev/hwt/hwt_ownerhash.h

sys/dev/hwt/hwt_ownerhash.c

sys/dev/hwt/hwt_record.h

sys/dev/hwt/hwt_record.c

sys/dev/hwt/hwt_thread.h

sys/dev/hwt/hwt_thread.c

sys/dev/hwt/hwt_vm.h

sys/dev/hwt/hwt_vm.c

sys/kern/imgact_elf.c

sys/kern/kern_hwt.c

sys/kern/kern_linker.c

sys/kern/kern_thr.c

sys/kern/kern_thread.c

sys/kern/sched_ule.c

sys/kern/vfs_vnops.c

sys/modules/hwt/Makefile

sys/sys/hwt.h

sys/sys/hwt_record.h

sys/sys/proc.h

sys/vm/vm_mmap.c

hwt(8) utility added
Needs ReviewPublic
Actions

Revision Contents
Changeset List