git.iko.soy/distributed-process
on master help sign in
Document the use of built-in trace flags
commitfc0a1ccdda06354e875373f61b45e5304e3687b1 authorTim Watson <watson.timothy@gmail.com> dateMon 1 Dec 2014, 15:00 (12 years ago) parent4e2e57c
1 file changed+13
src/Control/Distributed/Process/Debug.hs+13
src/Control/Distributed/Process/Debug.hs+13
@@ -78,6 +78,19 @@
7878-- This is checked for /any/ non-empty value. If set, all internal traces are
7979-- written to the GHC eventlog.
8080--
81+-- By default, the built in tracers will ignore all trace events! In order to
82+-- enable tracing the incoming 'MxEvent' stream, the @DISTRIBUTED_PROCESS_TRACE_FLAGS@
83+-- environment variable accepts the following flags, which enable tracing specific
84+-- event types:
85+--
86+-- p = trace the spawning of new processes
87+-- d = trace the death of processes
88+-- n = trace registration of names (i.e., named processes)
89+-- u = trace un-registration of names (i.e., named processes)
90+-- s = trace the sending of messages to other processes
91+-- r = trace the receipt of messages from other processes
92+-- l = trace node up/down events
93+--
8194-- Users of the /simplelocalnet/ Cloud Haskell backend should also note that
8295-- because the trace file option only supports trace output from a single node
8396-- (so as to avoid interleaving), a file trace configured for the master node