9srv Manual Collection/plan9/trace(1) 9srv Manual Collection/plan9/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 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

9srv Manual Collection/plan9/trace(1) Rev:  Sun Dec 02 23:42:16 GMT 2007