TRACE(1) TRACE(1)
NAME
trace - show (real-time) process behavior
SYNOPSIS
trace [ -d file ] [ -v ] [ -w ] [ pid ... ]
DESCRIPTION
Trace displays the behavior of processes running on the
machine. In its window it shows a time line for each traced
process. Running processes appear as colored blocks, with
arrows marking important events in real-time processes (see
proc(3)). Black up arrows mark process releases, black down
arrows mark process deadlines, green down arrows mark times
when a process yielded the processor before its deadline,
red down arrows mark times when the process overran its
allotted time.
Trace reads /proc/trace to retrieve trace events from the
kernel scheduler. Trace events are binary data structures
generated by the kernel scheduler. It is assumed that the
reader of /proc/trace and the kernel providing it have the
same byte order.
The options are:
-d specify an alternate trace event file
-v print events as they are read from the trace event file
-w run in a new window rather than using the current one
Trace recognizes these keystroke commands while it is run-
ning:
+ zoom in by a factor of two
- zoom out by a factor of two
p pause or resume
q quit
SEE ALSO
proc(3)
FILES
/proc/trace trace event file
/sys/include/trace.h trace event data structures
SOURCE
Page 1 Plan 9 (printed 10/29/25)
TRACE(1) TRACE(1)
/sys/src/cmd/trace.c
Page 2 Plan 9 (printed 10/29/25)