cddl/contrib/dtracetoolkit/Man/man1m/syscallbyproc.d.1m

   1 .TH syscallbyproc.d 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 syscallbyproc.d \- syscalls by process name. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B syscallbyproc.d
   6 .SH DESCRIPTION
   7 syscallbyproc.d is a DTrace OneLiner to a report of the number of
   8 system calls made by process name.
   9
  10 This is useful to identify which process is causing the most
  11 system calls.
  12
  13 Docs/oneliners.txt and Docs/Examples/oneliners_examples.txt
  14 in the DTraceToolkit contain this as a oneliner that can be cut-n-paste
  15 to run.
  16
  17 Since this uses DTrace, only the root user or users with the
  18 dtrace_kernel privilege can run this command.
  19 .SH OS
  20 Any
  21 .SH STABILITY
  22 stable - needs the syscall provider.
  23 .SH EXAMPLES
  24 .TP
  25 This samples until Ctrl\-C is hit.
  26 #
  27 .B syscallbyproc.d
  28 .PP
  29 .SH FIELDS
  30 .TP
  31 first field
  32 This is the process name. There may be several PIDs that have the
  33 same process name, for example with numerous instances of "bash". The
  34 value reported will be the sum of them all.
  35 .TP
  36 second field
  37 This is the count, the number of system calls made.
  38 .PP
  39 .SH DOCUMENTATION
  40 See the DTraceToolkit for further documentation under the
  41 Docs directory. The DTraceToolkit docs may include full worked
  42 examples with verbose descriptions explaining the output.
  43 .SH EXIT
  44 syscallbyproc.d will sample until Ctrl\-C is hit.
  45 .SH AUTHOR
  46 Brendan Gregg
  47 [Sydney, Australia]
  48 .SH SEE ALSO
  49 procsystime(1M), dtrace(1M), truss(1)
  50