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

   1 .TH procsystime 1m  "$Date:: 2007-08-05 #$" "USER COMMANDS"
   2 .SH NAME
   3 procsystime \- analyse system call times. Uses DTrace.
   4 .SH SYNOPSIS
   5 .B procsystime
   6 [\-acehoT] [ -p PID | -n name | command ]
   7 .SH DESCRIPTION
   8 procsystime prints details on system call times for processes,
   9 both the elapsed times and on-cpu times can be printed.
  10
  11 The elapsed times are interesting, to help identify syscalls
  12 that take some time to complete (during which the process may
  13 have slept). CPU time helps us identify syscalls that
  14 are consuming CPU cycles to run.
  15
  16 Since this uses DTrace, only the root user or users with the
  17 dtrace_kernel privilege can run this command.
  18 .SH OS
  19 Solaris
  20 .SH STABILITY
  21 stable - needs the syscall provider.
  22 .SH OPTIONS
  23 .TP
  24 \-a
  25 print all data
  26 .TP
  27 \-c
  28 print syscall counts
  29 .TP
  30 \-e
  31 print elapsed times, ns
  32 .TP
  33 \-o
  34 print CPU times, ns
  35 .TP
  36 \-T
  37 print totals
  38 .TP
  39 \-p PID
  40 examine this PID
  41 .TP
  42 \-n name
  43 examine processes which have this name
  44 .SH EXAMPLES
  45 .TP
  46 Print elapsed times for PID 1871,
  47 #
  48 .B procsystime
  49 \-p 1871
  50 .PP
  51 .TP
  52 Print elapsed times for processes called "tar",
  53 #
  54 .B procsystime
  55 \-n tar
  56 .PP
  57 .TP
  58 Print CPU times for "tar" processes,
  59 #
  60 .B procsystime
  61 \-on tar
  62 .PP
  63 .TP
  64 Print syscall counts for "tar" processes,
  65 #
  66 .B procsystime
  67 \-cn tar
  68 .PP
  69 .TP
  70 Print elapsed and CPU times for "tar" processes,
  71 #
  72 .B procsystime
  73 \-eon tar
  74 .PP
  75 .TP
  76 print all details for "bash" processes,
  77 #
  78 .B procsystime
  79 \-aTn bash
  80 .PP
  81 .TP
  82 run and print details for "df -h",
  83 #
  84 .B procsystime
  85 df \-h
  86 .PP
  87 .SH FIELDS
  88 .TP
  89 SYSCALL
  90 System call name
  91 .TP
  92 TIME (ns)
  93 Total time, nanoseconds
  94 .TP
  95 COUNT
  96 Number of occurrences
  97 .SH DOCUMENTATION
  98 See the DTraceToolkit for further documentation under the
  99 Docs directory. The DTraceToolkit docs may include full worked
 100 examples with verbose descriptions explaining the output.
 101 .SH EXIT
 102 procsystime will sample until Ctrl\-C is hit.
 103 .SH AUTHOR
 104 Brendan Gregg
 105 [Sydney, Australia]
 106 .SH SEE ALSO
 107 dtruss(1M), dtrace(1M), truss(1)
 108