|
|
1.1 ! root 1: .TH PROF 1 ! 2: .CT 1 debug_tune ! 3: .SH NAME ! 4: prof \(mi display profile data ! 5: .SH SYNOPSIS ! 6: .B prof ! 7: [ ! 8: .I option ... ! 9: ] ! 10: [ ! 11: .I a.out ! 12: [ ! 13: .I mon.out ... ! 14: ] ! 15: ] ! 16: .SH DESCRIPTION ! 17: .I Prof ! 18: interprets files ! 19: produced by ! 20: .IR monitor (3) ! 21: or the ! 22: .B -p ! 23: option of ! 24: .I cc ! 25: or ! 26: .I f77. ! 27: The symbol table in the ! 28: named object file ! 29: .RL ( a.out ! 30: by default) ! 31: is read and correlated with the ! 32: profile file ! 33: .RL ( mon.out ! 34: by default). ! 35: For each symbol, the percentage ! 36: of time spent executing between that symbol ! 37: and the next ! 38: is printed (in decreasing order), ! 39: together with the time spent there and ! 40: the number of times that routine was called. ! 41: If more than one profile file is specified, ! 42: the output represents the sum of the profiles. ! 43: .PP ! 44: Zero call counts are tallied for subroutines not compiled ! 45: with option ! 46: .BR -p . ! 47: The flag ! 48: .BR -p ! 49: must be passed to the loader to get the profiling output written. ! 50: .PP ! 51: Options are: ! 52: .TP ! 53: .B -l ! 54: Sort the output by symbol value. ! 55: .TP ! 56: .B -n ! 57: Sort the output by number of calls. ! 58: .TP ! 59: .B -s ! 60: Produce a summary profile file in ! 61: .FR mon.sum . ! 62: .TP ! 63: .BI "-v -" low " -" high ! 64: Produce a graphic profile ! 65: on the standard output for display by the ! 66: .IR plot (1) ! 67: filters. ! 68: Optional numbers ! 69: .I low ! 70: and ! 71: .I high, ! 72: by default 0 and 100, select ! 73: a percentage of the profile to be plotted. ! 74: .TP ! 75: .B -z ! 76: Include routines with zero usage in the output. ! 77: .SH FILES ! 78: .TF mon.out ! 79: .TP ! 80: .F mon.out ! 81: for profile ! 82: .TP ! 83: .F a.out ! 84: for namelist ! 85: .TP ! 86: .F mon.sum ! 87: for summary profile ! 88: .SH "SEE ALSO" ! 89: .IR time (1), ! 90: .IR lcomp (1), ! 91: .IR monitor (3), ! 92: .IR getopt (3), ! 93: .IR profil (2), ! 94: .IR plot (1), ! 95: .IR cc (1), ! 96: .IR f77 (1) ! 97: .SH BUGS ! 98: Beware of quantization errors. ! 99: .br ! 100: .I Prof ! 101: is confused by ! 102: .I f77, ! 103: which puts the entry points at the bottom of subroutines and functions.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.