term% cat index.txt TRACE(1) General Commands Manual 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 pro‐
cesses appear as colored blocks, with arrows marking important events
in real-time processes (see proc(3)). Black up arrows mark process re‐
leases, 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 sched‐
uler. 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 running:
+ 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
/sys/src/cmd/trace.c
TRACE(1)