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

   1 .TH topsyscall 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 topsyscall \- top syscalls by syscall name. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B topsyscall
   6 [-Cs] [interval [count]]
   7 .SH DESCRIPTION
   8 This program continually prints a report of the top system calls,
   9 and refreshes the display every 1 second or as specified at the
  10 command line.
  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 topsyscall
  31 .TP
  32 Print every 5 seconds,
  33 #
  34 .B topsyscall
  35 5
  36 .TP
  37 Print a scrolling output,
  38 #
  39 .B topsyscall
  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 SYSCALL
  54 system call name
  55 .TP
  56 COUNT
  57 total syscalls in this interval
  58 .TP
  59 COUNT/s
  60 syscalls per second
  61 .PP
  62 .SH DOCUMENTATION
  63 See the DTraceToolkit for further documentation under the
  64 Docs directory. The DTraceToolkit docs may include full worked
  65 examples with verbose descriptions explaining the output.
  66 .SH EXIT
  67 topsyscall will run until Ctrl\-C is hit, or the specified
  68 interval is reached.
  69 .SH AUTHOR
  70 Brendan Gregg
  71 [Sydney, Australia]
  72 .SH SEE ALSO
  73 dtrace(1M), prstat(1M)