Home | History | Annotate | Line # | Download | only in JavaScript 
      1 JavaScript - DTracing JavaScript
      2 
      3    There scripts trace the JavaScript programming language, and require a
      4    browser to be built with the DTrace JavaScript provider.
      5 
      6    The DTrace JavaScript provider was originally written by Brendan Gregg,
      7    and later developed as part of a Mozilla DTrace provider suite by
      8    engineers from both Sun and Mozilla. It currently exists as patches
      9    to the Mozilla source tree and requires building from source to get
     10    working; it may be integrated into Solaris builds by default in the
     11    future. To download the current patches and instructions, visit,
     12 
     13 	http://www.opensolaris.org/os/project/mozilla-dtrace/
     14 
     15    A rough guide for the process is,
     16 
     17 	1. Download the Mozilla source
     18 		http://developer.mozilla.org/en/docs/Mozilla_Source_Code_Via_CVS
     19 	2. Download the Mozilla DTrace framework patch, and apply
     20 		https://bugzilla.mozilla.org/show_bug.cgi?id=370906
     21 	3. Download the JavaScript DTrace provider patch, and apply
     22 		https://bugzilla.mozilla.org/show_bug.cgi?id=388564
     23 	4. Create a .mozconfig file (needed for compilation).
     24 	5. Setup various compilation environment vars (CC/CFLAGS/CXX/...)
     25 	6. autoconf
     26 	7. ./configure --enable-dtrace
     27 	8. gmake
     28 
     29    See John Rice's instructions linked from the OpenSolaris page above
     30    for details on steps 4-8.
     31 
     32    Since the DTrace JavaScript provider may be developed further, there is a
     33    chance that it has changed slightly by the time you are reading this,
     34    causing these scripts to either break or behave oddly. Firstly, check for
     35    newer versions of the DTraceToolkit; if it hasn't been updated and you need
     36    to use these scripts immediately, then updating them shouldn't take
     37    too long. The following was the state of the provider when these scripts
     38    were written - check for changes and update the scripts accordingly,
     39 
     40 	provider javascript {
     41 	    probe function-entry(file, class, func)
     42 	    probe function-info(file, class, func, lineno, runfile, runlineno)
     43 	    probe function-args(file, class, func, argc, argv, argv0, argv1,
     44 		argv2, argv3, argv4)
     45 	    probe function-rval(file, class, func, lineno, rval, rval0)
     46 	    probe function-return(file, class, func)
     47 	    probe object-create-start(file, class)
     48 	    probe object-create(file, class, *object, rlineno)
     49 	    probe object-create-done(file, class)
     50 	    probe object-finalize(NULL, class, *object)
     51 	    probe execute-start(file, lineno)
     52 	    probe execute-done(file, lineno)
     53 	};
     54 
     55