BTRACE(8) - System Manager’s Manual #
BTRACE(8) - System Manager’s Manual
NAME #
btrace - bug tracer
SYNOPSIS #
btrace [-lnv] [-e program | file] [-p file] [argument …]
DESCRIPTION #
The btrace utility provides an interface to inspect the internals of the system and programs. It interprets the bt(5) program in file and communicates with the dynamic tracer device using the interface described in dt(4).
The options are as follows:
-e program
Execute program.
-l
List all available probes.
-n
No action. Parse the program and then exit.
-p file
Load symbols from file to convert ustack addresses into function names.
-v
Verbose mode. Causes btrace to print debugging messages. Multiple -v options increase the verbosity. The maximum is 2.
FILES #
/usr/share/btrace/*
collection of useful btrace programs
EXIT STATUS #
The btrace utility exits 0 on success, and >0 if an error occurs.
SEE ALSO #
HISTORY #
The btrace utility first appeared in OpenBSD 6.7.
AUTHORS #
Martin Pieuchot <mpi@openbsd.org>
OpenBSD 7.5 - September 15, 2023