|
|
@@ -50,9 +50,11 @@ prints the dynamic call graph of the target program,
|
|
|
annotating the calls with the time spent in each routine
|
|
|
and those it calls, recursively. The output is indented
|
|
|
two spaces for each call, and is formatted as
|
|
|
+.IP
|
|
|
.EX
|
|
|
- symbol:time/ncall
|
|
|
+symbol:time/ncall
|
|
|
.EE
|
|
|
+.LP
|
|
|
where
|
|
|
.I symbol
|
|
|
is the entry point of the call,
|
|
|
@@ -87,9 +89,11 @@ producing a file called
|
|
|
.B prof.\f2pid\fP.
|
|
|
If a process forks, only the parent will continue to be profiled. Forked children
|
|
|
can cause themselves to be profile by calling
|
|
|
+.IP
|
|
|
.EX
|
|
|
- prof(fn, arg, entries, what)
|
|
|
+prof(fn, arg, entries, what)
|
|
|
.EE
|
|
|
+.LP
|
|
|
which causes the function \f2fn\fP(\f2arg\fP) to be profiled. When \f2fn\fP
|
|
|
returns
|
|
|
.B prof.\f2pid\fP
|
|
|
@@ -120,13 +124,17 @@ It must be run while the program is still active, since the data is stored with
|
|
|
To enable
|
|
|
.I tprof
|
|
|
profiling for a given process,
|
|
|
+.IP
|
|
|
.EX
|
|
|
- echo profile > /proc/\f2pid\f1/ctl
|
|
|
+echo profile > /proc/\f2pid\f1/ctl
|
|
|
.EE
|
|
|
+.LP
|
|
|
and then, after the program has run for a while, execute
|
|
|
+.IP
|
|
|
.EX
|
|
|
- tprof \f2pid\f1
|
|
|
+tprof \f2pid\f1
|
|
|
.EE
|
|
|
+.LP
|
|
|
Since the data collected for
|
|
|
.I tprof
|
|
|
is based on interrupt-time sampling of the program counter,
|
|
|
@@ -155,4 +163,5 @@ has no options and cannot present dynamic data.
|
|
|
.B /sys/src/cmd/kprof.c
|
|
|
.SH SEE ALSO
|
|
|
.IR 2l (1),
|
|
|
+.IR exec (2),
|
|
|
.IR kprof (3)
|
David du Colombier