Return to prof CVS log

Up to [Plan 9 NeXT] / lucent / sys / man / 1

Annotation of lucent/sys/man/1/prof, revision 1.1.1.1

1.1       root        1: .TH PROF 1
                      2: .SH NAME
                      3: prof, kprof \- display profiling data
                      4: .SH SYNOPSIS
                      5: .B prof
                      6: [
                      7: .B -dr
                      8: ]
                      9: [
                     10: .I program
                     11: ]
                     12: [
                     13: .I profile
                     14: ]
                     15: .PP
                     16: .B kprof
                     17: .I kernel
                     18: .I kpdata
                     19: .SH DESCRIPTION
                     20: .I Prof
                     21: interprets files produced automatically by programs loaded using the
                     22: .B -p
                     23: option of
                     24: .IR 2l (1)
                     25: or other loader.
                     26: The symbol table in the
                     27: named program file
                     28: .RL ( v.out
                     29: by default)
                     30: is read and correlated with the
                     31: profile file
                     32: .RL ( prof.out
                     33: by default).
                     34: For each symbol, the percentage
                     35: of time (in seconds) spent executing between that symbol
                     36: and the next
                     37: is printed (in decreasing order),
                     38: together with the time spent there and
                     39: the number of times that routine was called.
                     40: .PP
                     41: Under option
                     42: .BR -d ,
                     43: .I prof
                     44: prints the dynamic call graph of the target program,
                     45: annotating the calls with the time spent in each routine
                     46: and those it calls, recursively.  The output is indented
                     47: two spaces for each call, and is formatted as
                     48: .EX
                     49:        symbol:time/ncall
                     50: .EE
                     51: where
                     52: .I symbol
                     53: is the entry point of the call,
                     54: .I time
                     55: is in milliseconds,
                     56: and
                     57: .I ncall
                     58: is the number of times that entry point was called at that
                     59: point in the call graph.  If
                     60: .I ncall
                     61: is one, the
                     62: .B /ncall
                     63: is elided.
                     64: Normally recursive calls are compressed to keep the output brief;
                     65: option
                     66: .B -r
                     67: prints the full call graph.
                     68: .PP
                     69: The size of the buffer
                     70: in
                     71: .I program
                     72: used to hold the profiling
                     73: data, by default 2000 entries,
                     74: may be controlled by setting the environment variable
                     75: .B profsize
                     76: before running
                     77: .IR program .
                     78: If the buffer fills, subsequent function calls may not be recorded.
                     79: .PP
                     80: .I Kprof
                     81: is similar to
                     82: .IR prof ,
                     83: but presents the data accumulated by the kernel
                     84: profiling device,
                     85: .IR kprof (3) .
                     86: The symbol table file, that of the operating system kernel,
                     87: and the data file, typically
                     88: .BR /dev/kpdata ,
                     89: must be provided.
                     90: .I Kprof
                     91: has no options and cannot present dynamic data.
                     92: .SH SOURCE
                     93: .B /sys/src/cmd/prof.c
                     94: .br
                     95: .B /sys/src/cmd/kprof.c
                     96: .SH SEE ALSO
                     97: .IR 2l (1),
                     98: .IR kprof (3)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.