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

   1 .TH js_objgc.d 1m   "$Date:: 2007-10-03 #$" "USER COMMANDS"
   2 .SH NAME
   3 js_objgc.d - trace JavaScript Object GC using DTrace.
   4 .SH SYNOPSIS
   5 .B js_objgc.d
   6
   7 .SH DESCRIPTION
   8 This traces JavaScript activity from all running browers on the system
   9 which support the JavaScript DTrace provider.
  10
  11 This script provides information on which objects are not being garbage
  12 collected, an issue which causes the browser to steadily leak memory.
  13 We trace object creation (+1) and destruction (-1), and provide a
  14 summary each second of the running tally of the object class and
  15 originating filename. If over the period of several minutes an object
  16 type is still steadily increasing, then that would be of interest.
  17 Be patient, depending on the rate of object creation it can take over
  18 ten minutes for garbage collect to kick in.
  19 .SH OS
  20 Any
  21 .SH STABILITY
  22 Evolving - uses the DTrace JavaScript provider, which may change
  23 as additional features are introduced. Check JavaScript/Readme
  24 to see what version these scripts are based on.
  25 .SH EXAMPLES
  26 .TP
  27 Default output,
  28 #
  29 .B js_objgc.d
  30 .PP
  31 .SH FIELDS
  32 .TP
  33 FILE
  34 Filename that contained the function
  35 .TP
  36 CLASS
  37 Class to which this new object belongs
  38 .TP
  39 TOTAL
  40 Object entropy (positive == uncollected)
  41 .SH NOTES
  42
  43 \- it is possible that you will see negative entropy. That happens
  44 when you begin tracing after some objects have already been created,
  45 and then trace their destruction.
  46 \- there are other Things that GC handles, other than Objects; extra
  47 probes can be added to trace them, should the need arise.
  48 .PP
  49 .SH DOCUMENTATION
  50 See the DTraceToolkit for further documentation under the
  51 Examples, Notes and Docs directories. The example files may be
  52 especially useful as they aim to demonstrate how to interpret
  53 the output.
  54 .SH EXIT
  55 js_objgc.d will run until Ctrl-C is hit.
  56 .SH AUTHOR
  57 Brendan Gregg
  58 [CA, USA]
  59 .SH SEE ALSO
  60 dtrace(1M)