home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Trees / V6 / usr / man / man8 / sa.8 < prev    next >
Encoding:
Text File  |  1975-06-26  |  2.3 KB  |  101 lines
  1. .th SA VIII 6/1/74
  2. .sh NAME
  3. sa \*- Shell accounting
  4. .sh SYNOPSIS
  5. sa [
  6. .bd \*-abcjlnrstuv
  7. ] [ file ]
  8. .sh DESCRIPTION
  9. When a user logs in,
  10. if the Shell is able to open the file
  11. .it /usr/adm/sha,
  12. then as each command completes the Shell writes at the end of this file
  13. the name of the command, the user, system, and real
  14. time consumed,
  15. and the user ID.
  16. .it Sa
  17. reports on, cleans up, and generally maintains this and other
  18. accounting files.
  19. To turn accounting on and off,
  20. the accounting file must be created or destroyed
  21. externally.
  22. .s3
  23. .it Sa
  24. is able to condense
  25. the information in
  26. .it /usr/adm/sha
  27. into a summary file
  28. .it /usr/adm/sht
  29. which contains a count of the
  30. number of times each command was called and the time resources
  31. consumed.
  32. This condensation is desirable because on a large system
  33. .it sha
  34. can grow by 100 blocks per day.
  35. The summary file is read before the accounting file,
  36. so the reports include all available information.
  37. .s3
  38. If a file name is given as the last argument,
  39. that file will be treated
  40. as the accounting file;
  41. .it sha
  42. is the default.
  43. There are zillions of options:
  44. .s3
  45. .de qq
  46. .s3
  47. .lp +3 3
  48. \fB\\$1\fR    \\
  49. ..
  50. .qq a
  51. Place all command names containing unprintable characters
  52. and those used only once under the name ``***other.''
  53. .qq b
  54. Sort output by sum of user and system time divided by number of
  55. calls.
  56. Default sort is by sum of user and system times.
  57. .qq c
  58. Besides total user, system, and real time for each command print percentage
  59. of total time over all commands.
  60. .qq j
  61. Instead of total minutes time for each category,
  62. give seconds per call.
  63. .qq l
  64. Separate system and user time; normally they are combined.
  65. .qq n
  66. Sort by number of calls.
  67. .qq r
  68. Reverse order of sort.
  69. .qq s
  70. Merge accounting file into summary file
  71. .it /usr/adm/sht
  72. when done.
  73. .qq t
  74. For each command report ratio of real time to the sum of user and
  75. system times.
  76. .qq u
  77. Superseding all other flags,
  78. print for each command in the accounting file the
  79. day of the year, time, day of the week,
  80. user ID and command name.
  81. .qq v
  82. If the next character is a digit
  83. .it n,
  84. then type the name of
  85. each command used
  86. .it n
  87. times or fewer.
  88. Await a reply from the typewriter;
  89. if it begins with ``y'', add the command to
  90. the category ``**junk**.''
  91. This is used to strip out garbage.
  92. .i0
  93. .dt
  94. .sh FILES
  95. /usr/adm/sha    accounting
  96. .br
  97. /usr/adm/sht    summary
  98. .sh "SEE ALSO"
  99. ac (VIII)
  100. .sh BUGS
  101.