X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=docs%2Fusers_guide%2Fruntime_control.xml;h=62a01acdda4b35b98dbe307c4a24c7fd48ff538d;hb=029c4588e6e022aa15e465cc67082378d4ee2bea;hp=995e26302dda2c2a7d4cdf224c6c841849f3fd41;hpb=071367ea146fa1622e2e533fc9cf804c2be14a57;p=ghc-hetmet.git
diff --git a/docs/users_guide/runtime_control.xml b/docs/users_guide/runtime_control.xml
index 995e263..62a01ac 100644
--- a/docs/users_guide/runtime_control.xml
+++ b/docs/users_guide/runtime_control.xml
@@ -85,6 +85,54 @@
+
+ Miscellaneous RTS options
+
+
+
+
+ RTS
+ option
+
+ Sets the interval that the RTS clock ticks at. The
+ runtime uses a single timer signal to count ticks; this timer
+ signal is used to control the context switch timer () and the heap profiling
+ timer . Also, the
+ time profiler uses the RTS timer signal directly to record
+ time profiling samples.
+
+ Normally, setting the option
+ directly is not necessary: the resolution of the RTS timer is
+ adjusted automatically if a short interval is requested with
+ the or options.
+ However, setting is required in order to
+ increase the resolution of the time profiler.
+
+ Using a value of zero disables the RTS clock
+ completely, and has the effect of disabling timers that
+ depend on it: the context switch timer and the heap profiling
+ timer. Context switches will still happen, but
+ deterministically and at a rate much faster than normal.
+ Disabling the interval timer is useful for debugging, because
+ it eliminates a source of non-determinism at runtime.
+
+
+
+
+
+ RTS
+ option
+
+ If yes (the default), the RTS installs signal handlers to catch
+ things like ctrl-C. This option is primarily useful for when
+ you are using the Haskell code as a DLL, and want to set your
+ own signal handlers.
+
+
+
+
+
RTS options to control the garbage collector
@@ -398,11 +446,12 @@
- RTS options for profiling and Concurrent/Parallel Haskell
+ RTS options for profiling and parallelismThe RTS options related to profiling are described in ; and those for concurrent/parallel
- stuff, in .
+ linkend="rts-options-heap-prof"/>, those for concurrency in
+ , and those for parallelism in
+ .
@@ -612,6 +661,29 @@ char *ghc_rts_opts = "-H128m -K1m";
ghc/compiler/parser/hschooks.c in a GHC
source tree.
+
+
+ Getting information about the RTS
+
+ RTS
+
+ It is possible to ask the RTS to give some information about
+ itself. To do this, use the flag, e.g.
+
+$ ./a.out +RTS --info
+ [("GHC RTS", "Yes")
+ ,("GHC version", "6.7")
+ ,("RTS way", "rts_p")
+ ,("Host platform", "x86_64-unknown-linux")
+ ,("Build platform", "x86_64-unknown-linux")
+ ,("Target platform", "x86_64-unknown-linux")
+ ,("Compiler unregisterised", "NO")
+ ,("Tables next to code", "YES")
+ ]
+
+ The information is formatted such that it can be read as a
+ of type [(String, String)].
+