Return to monitor.3 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man3

Annotation of researchv10dc/man/adm/man3/monitor.3, revision 1.1.1.1

1.1       root        1: .TH MONITOR 3
                      2: .CT 2 debug_tune
                      3: .SH NAME
                      4: monitor \(mi prepare execution profile
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B monitor(lowpc, highpc, buffer, bufsize, nfunc)
                      8: .B int (*lowpc)(), (*highpc)();
                      9: .B short buffer[];
                     10: .fi
                     11: .SH DESCRIPTION
                     12: An executable program created by
                     13: .L
                     14: cc -p
                     15: automatically includes calls for
                     16: .I monitor
                     17: with default parameters;
                     18: .I monitor
                     19: needn't be called explicitly
                     20: except to gain fine control over profiling.
                     21: .PP
                     22: .I Monitor
                     23: is an interface to
                     24: .IR profil (2).
                     25: .I Lowpc
                     26: and
                     27: .I highpc
                     28: are the addresses of two functions;
                     29: .I buffer
                     30: is the address of a (user supplied)
                     31: array of
                     32: .I bufsize
                     33: bytes.
                     34: .I Monitor
                     35: arranges to record a histogram of
                     36: periodically sampled values of the program counter,
                     37: and of counts of calls
                     38: of certain functions, in the buffer.
                     39: The lowest address sampled
                     40: is that of
                     41: .I lowpc
                     42: and the highest is
                     43: just below
                     44: .IR highpc .
                     45: At most
                     46: .I nfunc
                     47: call counts can be kept; only calls of functions
                     48: compiled with the profiling option
                     49: .B -p
                     50: of
                     51: .IR cc (1)
                     52: are recorded.
                     53: For the results to be significant,
                     54: especially where there are small, heavily
                     55: used routines,
                     56: it is suggested that the buffer be no more
                     57: than a few times smaller than the range
                     58: of locations sampled.
                     59: The default values for
                     60: .I bufsize
                     61: and
                     62: .I nfunc
                     63: are
                     64: (\f2highpc\fP\-\f2lowpc\fP)/8
                     65: and 300 respectively.
                     66: .PP
                     67: To profile the entire program, use
                     68: .PP
                     69: .nf
                     70: .ft L
                     71:        extern etext();
                     72:        . . .
                     73:        monitor((int (*)())2, etext, buf, bufsize, nfunc);
                     74: .ft P
                     75: .fi
                     76: .PP
                     77: .I Etext
                     78: lies just above all the
                     79: program text, see
                     80: .IR end (3).
                     81: For the highest resolution profiling on the VAX, use
                     82: .B
                     83: bufsize = ((int)highpc)-((int)lowpc)+12+8*nfunc\fR.
                     84: .PP
                     85: To stop execution monitoring and write the results
                     86: on the file
                     87: .I mon.out,
                     88: use
                     89: .PP
                     90: .L
                     91:        monitor((int (*)())0);
                     92: .LP
                     93: then
                     94: .IR prof (1)
                     95: can be used
                     96: to examine the results.
                     97: .SH FILES
                     98: .TP
                     99: .F mon.out
                    100: .SH "SEE ALSO"
                    101: .IR prof (1), 
                    102: .IR profil (2), 
                    103: .IR cc (1)

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