home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Trees / V6 / usr / man / man1 / prof.1 < prev    next >
Encoding:
Text File  |  1975-06-26  |  1.3 KB  |  74 lines
  1. .th PROF I 3/12/73
  2. .sh NAME
  3. prof \*- display profile data
  4. .sh SYNOPSIS
  5. .bd prof
  6. [
  7. .bd \*-v
  8. ] [
  9. .bd \*-a
  10. ] [
  11. .bd \*-l
  12. ] [ file ]
  13. .sh DESCRIPTION
  14. .it Prof
  15. interprets the file
  16. .it mon.out
  17. produced by the
  18. .it monitor
  19. subroutine.
  20. Under default modes,
  21. the symbol table in the
  22. named object file
  23. .it (a.out
  24. default)
  25. is read and correlated with the
  26. .it mon.out
  27. profile file.
  28. For each external symbol, the percentage
  29. of time spent executing between that symbol
  30. and the next
  31. is printed (in decreasing order),
  32. together with the number of times that routine was called
  33. and the number of milliseconds per call.
  34. .s3
  35. If the
  36. .bd \*-a
  37. option is used,
  38. all symbols are reported rather than
  39. just external symbols.
  40. If the
  41. .bd \*-l
  42. option
  43. is used,
  44. the output is listed by
  45. symbol value rather than
  46. decreasing percentage.
  47. If the
  48. .bd \*-v
  49. option is used,
  50. all printing is suppressed
  51. and a profile plot is produced
  52. on the 611 display.
  53. .s3
  54. In order for the number of calls to a routine to be tallied,
  55. the
  56. .bd \*-p
  57. option of
  58. .it cc
  59. must have been given when the file containing the
  60. routine was compiled.
  61. This option also arranges for the
  62. .it mon.out
  63. file to be produced automatically.
  64. .sh FILES
  65. mon.out    for profile
  66. .br
  67. a.out        for namelist
  68. .br
  69. /dev/vt0    for plotting
  70. .sh "SEE ALSO"
  71. monitor (III), profil (II), cc (I)
  72. .sh BUGS
  73. Beware of quantization errors.
  74.