Changes between Version 1 and Version 2 of DTrace

Timestamp:

12/12/09 02:26:02 (4 years ago)

Author:

chak

Comment:

--

DTrace

@@ -1 +1 @@
 = Using DTrace with GHC =
 
-GHC 6.13 includes DTrace probes in the runtime system.  Currently, these probes correspond to the events of the EventLog framework and are only available on Mac OS X.
+GHC 6.13 includes DTrace probes in the runtime system.  Currently, these probes correspond to the events of the EventLog framework and are only available on Mac OS X (from Leopard onwards).
 
-It is straight forward to extend the current implementation with additional probes, and due to the lightweight nature of DTrace, new probes could inspect the runtime system and running Haskell program even in a more fine-grained manner.
+It is straight forward to extend the current implementation with additional probes, and due to the lightweight nature of DTrace, new probes could inspect the runtime system and running Haskell program in an even more fine-grained manner.
+
+== Probes ==
+
+The provider is defined as follows:
+{{{
+provider HaskellEvent {
+
+  // scheduler events
+  probe create__thread (EventCapNo, EventThreadID);
+  probe run__thread (EventCapNo, EventThreadID);
+  probe stop__thread (EventCapNo, EventThreadID, EventThreadStatus);
+  probe thread__runnable (EventCapNo, EventThreadID);
+  probe migrate__thread (EventCapNo, EventThreadID, EventCapNo);
+  probe run__spark (EventCapNo, EventThreadID);
+  probe steal__spark (EventCapNo, EventThreadID, EventCapNo);
+  probe shutdown (EventCapNo);
+  probe thread_wakeup (EventCapNo, EventThreadID, EventCapNo);
+  probe gc__start (EventCapNo);
+  probe gc__end (EventCapNo);
+  probe request__seq__gc (EventCapNo);
+  probe request__par__gc (EventCapNo);
+  probe create__spark__thread (EventCapNo, EventThreadID);
+
+  // other events
+  probe startup (EventCapNo);
+  probe user__msg (EventCapNo, char *);
+  probe gc__idle (EventCapNo);
+  probe gc__work (EventCapNo);
+  probe gc__done (EventCapNo);
+
+};
+}}}
+where we have
+{{{
+typedef uint32_t EventThreadID;
+typedef uint16_t EventCapNo;
+typedef uint16_t EventThreadStatus;
+}}}
+The two events `EVENT_LOG_MSG` and `EVENT_BLOCK_MARKER` are not supported.  The former doesn't appear to be used and the latter appears to be an artefact of the event log file format.
 
 == Portability ==
 
-User-space DTrace probes are implemented differently on Mac OS X than in the original DTrace implementation; see under the heading '''BUILDING CODE CONTAINING USDT PROBES''' at [http://developer.apple.com/mac/library/documentation/Darwin/Reference/ManPages/man1/dtrace.1.html].  Nevertheless, it shouldn't be too hard to enable these probes on other platforms, too.
+User-space DTrace probes are implemented differently on Mac OS X than in the original DTrace implementation; see under the heading ''BUILDING CODE CONTAINING USDT PROBES'' in the [http://developer.apple.com/mac/library/documentation/Darwin/Reference/ManPages/man1/dtrace.1.html Mac OS X dtrace man page].  Nevertheless, it shouldn't be too hard to enable these probes on other platforms, too.