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

   1 .TH j_syscolors.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 j_syscolors.d - trace Java method flow plus syscalls, in color.
   4 .SH SYNOPSIS
   5 .B j_syscolors.d
   6 { \-p PID | \-c cmd }
   7 .SH DESCRIPTION
   8 This traces Java methods if the hotspot provider exists (1.6.0) and
   9 the flag "+ExtendedDTraceProbes" is used. eg,
  10 java -XX:+ExtendedDTraceProbes classfile
  11
  12 This watches Java method entries and returns, and indents child
  13 method calls.
  14
  15 If the flow appears to jump, check the TID column - the JVM may have
  16 switched to another thread.
  17 .SH OS
  18 Solaris
  19 .SH STABILITY
  20 Evolving - uses the DTrace hotspot provider, which may change
  21 as additional features are introduced. Check Java/Readme
  22 to see what version these scripts are based on.
  23 .SH EXAMPLES
  24 .TP
  25 Default output,
  26 #
  27 .B j_syscolors.d
  28 .PP
  29 .SH FIELDS
  30 .TP
  31 C
  32 CPU-id
  33 .TP
  34 PID
  35 Process ID
  36 .TP
  37 TID
  38 Thread ID
  39 .TP
  40 DELTA(us)
  41 Elapsed time from previous line to this line
  42 .TP
  43 TYPE
  44 Type of call (func/syscall)
  45 .TP
  46 NAME
  47 Java method or syscall name
  48 .SH WARNING
  49 Watch the first column carefully, it prints the CPU-id. If it
  50 changes, then it is very likely that the output has been shuffled.
  51 Changes in TID will appear to shuffle output, as we change from one thread
  52 depth to the next. See Docs/Notes/ALLjavaflow.txt for additional notes.
  53 .PP
  54 .SH DOCUMENTATION
  55 See the DTraceToolkit for further documentation under the
  56 Examples, Notes and Docs directories. The example files may be
  57 especially useful as they aim to demonstrate how to interpret
  58 the output.
  59 .SH EXIT
  60 j_syscolors.d will run until Ctrl-C is hit.
  61 .SH AUTHOR
  62 Brendan Gregg
  63 [CA, USA]
  64 .SH SEE ALSO
  65 dtrace(1M)