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 running:

+

zoom in by a factor of two  

-

zoom out by a factor of two  

p

pause or resume  

q

quit  

SEE

proc(3)

FILES

/proc/trace

trace event file  

/sys/include/trace.h

trace event data structures  

SOURCE

/sys/src/cmd/trace.c