home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Trees / V6 / usr / man / man2 / profil.2 < prev    next >
Encoding:
Text File  |  1975-06-26  |  1.2 KB  |  57 lines
  1. .th PROFIL II 5/15/74
  2. .sh NAME
  3. profil \*- execution time profile
  4. .sh SYNOPSIS
  5. (profil = 44.; not in assembler)
  6. .br
  7. .ft B
  8. sys    profil; buff; bufsiz; offset; scale
  9. .s3
  10. profil(buff, bufsiz, offset, scale)
  11. .br
  12. char buff[ ];
  13. .br
  14. int bufsiz, offset, scale;
  15. .ft R
  16. .sh DESCRIPTION
  17. .it Buff
  18. points to an area of core whose length (in bytes) is given by
  19. .it bufsiz.
  20. After this call, the user's program counter (pc)
  21. is examined each clock tick (60th second);
  22. .it offset
  23. is subtracted from it, and the result multiplied by
  24. .it scale.
  25. If the resulting number corresponds to a word
  26. inside
  27. .it buff,
  28. that word is incremented.
  29. .s3
  30. The scale is interpreted as an unsigned,
  31. fixed-point fraction with binary point at the
  32. left: 177777(8) gives a 1-1 mapping of pc's to words
  33. in
  34. .it buff;
  35. 77777(8) maps each pair of instruction words
  36. together.
  37. 2(8) maps all instructions onto the beginning of
  38. .it buff
  39. (producing a non-interrupting core clock).
  40. .s3
  41. Profiling is turned off by giving a
  42. .it scale
  43. of 0 or 1.
  44. It is rendered
  45. ineffective by giving a
  46. .it bufsiz
  47. of 0.
  48. Profiling is also turned off when an
  49. .it exec
  50. is executed but remains on in child and parent both
  51. after a
  52. .it fork.
  53. .sh "SEE ALSO"
  54. monitor (III), prof (I)
  55. .sh DIAGNOSTICS
  56. \*-
  57.