man(1) Manual page archive


     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 run-
          ning:

          +    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

     TRACE(1)                                                 TRACE(1)

          /sys/src/cmd/trace.c