glenda.party
term% ls -F
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)