Sfink/JS Profiling-Related APIs: Difference between revisions

← Older edit

Sfink/JS Profiling-Related APIs (view source)

Revision as of 22:17, 30 July 2010

13 bytes added , 30 July 2010

m

no edit summary

Sfink

Confirmed users

328

edits

@@ Line 1: / Line 1: @@
 I've crawled around js/src/ and attempted to summarize the various APIs used for profiling-related tasks. Some of these are straight profilers, some are general debugging hooks.
-* vtune
+== vtune ==
-** #ifdef MOZ_VTUNE
-** jsdbgapi: start/stop/pause/resume API
+* #ifdef MOZ_VTUNE
-** global functions for JS shell & mozJSComponentLoader (NOT xpcshell!)
+* jsdbgapi: start/stop/pause/resume API
-* shark
+* global functions for JS shell & mozJSComponentLoader (NOT xpcshell!)
-** #ifdef MOZ_SHARK
-** jsdbgapi: start/stop/connect/disconnect API (2 unused; should be static?)
+== shark ==
-** global functions for JS shell & mozJSComponentLoader & xpcshell
-** command-line option -k for JS shell & xpcshell
+* #ifdef MOZ_SHARK
-* callgrind
+* jsdbgapi: start/stop/connect/disconnect API (2 unused; should be static?)
-** #ifdef MOZ_CALLGRIND
+* global functions for JS shell & mozJSComponentLoader & xpcshell
-** jsdbgapi: start/stop/dump API
+* command-line option -k for JS shell & xpcshell
-** global functions for JS shell & mozJSComponentLoader & xpcshell
-* dtrace
+== callgrind ==
-** #ifdef INCLUDE_MOZILLA_DTRACE
-** start/stop API unnecessary
+* #ifdef MOZ_CALLGRIND
-** jsdtracef: enter/exit/execute-enter/execute-exit/objectCreate/finalize probes
+* jsdbgapi: start/stop/dump API
-** probes in jsgc.cpp, jsinterp.cpp, jsobjinlines.h (obj create), NOT jstracer
+* global functions for JS shell & mozJSComponentLoader & xpcshell
-* jscall ({{bug|507012}})
-** #ifdef MOZ_TRACE_JSCALLS
+== dtrace ==
-** jsapi.h, jscntxt.h: get/set callback API
-** piggybacks on dtrace probes but adds in jstracer probes
+* #ifdef INCLUDE_MOZILLA_DTRACE
-** start/stop done in nsJSEnvironment ({{bug|580055}}), may add a js/ variant
+* start/stop API unnecessary
-* debughooks (jsdv1)
+* jsdtracef: enter/exit/execute-enter/execute-exit/objectCreate/finalize probes
-** unconditionally included
+* probes in jsgc.cpp, jsinterp.cpp, jsobjinlines.h (obj create), NOT jstracer
-** jsdbgapi: get/set/clear
-** specific hooks enumerated in JSDebugHooks in jsprvtd.h
+== jscall ({{bug|507012}}) ==
-** jsprvtd.h: interrupt/newScript/destroyScript/execute/call/throw hooks + some debugger,source code,error stuff
+* #ifdef MOZ_TRACE_JSCALLS
-** hooks in jsinterp.cpp (almost everything here), jsscan.cpp (source code), jsscript.cpp (newScript,destroyScript), jstracer (callHook when synthesizing a frame)
+* jsapi.h, jscntxt.h: get/set callback API
-** usage disables trace JIT
+* piggybacks on dtrace probes but adds in jstracer probes
-* jsdv2
+* start/stop done in nsJSEnvironment ({{bug|580055}}), may add a js/ variant
-** sorry, I don't know where this is to look at it. I've only read the spec.
+== debughooks (jsdv1) ==
+* unconditionally included
+* jsdbgapi: get/set/clear
+* specific hooks enumerated in JSDebugHooks in jsprvtd.h
+* jsprvtd.h: interrupt/newScript/destroyScript/execute/call/throw hooks + some debugger,source code,error stuff
+* hooks in jsinterp.cpp (almost everything here), jsscan.cpp (source code), jsscript.cpp (newScript,destroyScript), jstracer (callHook when synthesizing a frame)
+* usage disables trace JIT
+== jsdv2 ==
+* sorry, I don't know where this is to look at it. I've only read the spec.