Import sources from 2011-03-30 iso image - sys/man

1 files changed, 84 insertions, 0 deletions

diff --git a/sys/man/1/trace b/sys/man/1/trace
new file mode 100755
index 000000000..6acabe11d
--- /dev/null
+++ b/sys/man/1/trace
@@ -0,0 +1,84 @@
+.TH TRACE 1
+.SH NAME
+trace \- show (real-time) process behavior
+.SH SYNOPSIS
+.B trace
+[
+.B -d
+.I file
+]
+[
+.B -v
+]
+[
+.B -w
+]
+[
+.I pid
+\&...
+]
+.SH DESCRIPTION
+.I 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
+.IR 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.
+.PP
+.I Trace
+reads
+.B /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
+.B /proc/trace
+and the kernel providing it have the same byte order.
+.PP
+The options are:
+.TP
+.B -d
+specify an alternate trace event file
+.TP
+.B -v
+print events as they are read from the trace event file
+.TP
+.B -w
+run in a new window rather than using the current one
+.PD
+.PP
+.I Trace
+recognizes these keystroke commands while it is running:
+.TP
+.B +
+zoom in by a factor of two
+.TP
+.B -
+zoom out by a factor of two
+.TP
+.B p
+pause or resume
+.TP
+.B q
+quit
+.PD
+.PP
+.SH SEE ALSO
+.IR proc (3)
+.SH FILES
+.TF /sys/include/trace.h
+.TP
+.B /proc/trace
+trace event file
+.TP
+.B /sys/include/trace.h
+trace event data structures
+.PD
+.SH SOURCE
+.B /sys/src/cmd/trace.c