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

Plan 9  —  December 02, 2007