cddl/contrib/dtracetoolkit/Man/man1m/topsysproc.1m

   1 .TH topsysproc 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 topsysproc \- top syscalls by process name. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B topsysproc
   6 [-Cs] [interval [count]]
   7 .SH DESCRIPTION
   8 This program continually prints a report of the number of system calls
   9 by process name, and refreshes the display every 1 second or as specified
  10 at the command line. Similar data can be fetched with "prstat -m".
  11
  12 Since this uses DTrace, only the root user or users with the
  13 dtrace_kernel privilege can run this command.
  14 .SH OS
  15 Solaris
  16 .SH STABILITY
  17 unstable - uses the hp_avenrun kernel symbol.
  18 .SH OPTIONS
  19 .TP
  20 \-C
  21 don't clear the screen
  22 .TP
  23 \-s
  24 print per second values
  25 .PP
  26 .SH EXAMPLES
  27 .TP
  28 Default output, 1 second updates,
  29 #
  30 .B topsysproc
  31 .TP
  32 Print every 5 seconds,
  33 #
  34 .B topsysproc
  35 5
  36 .TP
  37 Print a scrolling output,
  38 #
  39 .B topsysproc
  40 \-C
  41 .PP
  42 .SH FIELDS
  43 .TP
  44 load avg
  45 load averages, see uptime(1)
  46 .TP
  47 syscalls
  48 total syscalls in this interval
  49 .TP
  50 syscalls/s
  51 syscalls per second
  52 .TP
  53 PROCESS
  54 process name
  55 .TP
  56 COUNT
  57 total syscalls in this interval
  58 .TP
  59 COUNT/s
  60 syscalls per second
  61 .PP
  62 .SH NOTES
  63 There may be several PIDs with the same process name.
  64 .PP
  65 .SH DOCUMENTATION
  66 See the DTraceToolkit for further documentation under the
  67 Docs directory. The DTraceToolkit docs may include full worked
  68 examples with verbose descriptions explaining the output.
  69 .SH EXIT
  70 topsysproc will run until Ctrl\-C is hit.
  71 .SH AUTHOR
  72 Brendan Gregg
  73 [Sydney, Australia]
  74 .SH SEE ALSO
  75 dtrace(1M), prstat(1M)