Better hints when RTS options not available (Trac #9579)

This patch provides user with a better hint when most RTS options
are not available (not compiled with `-rtsopts`).

A new field "rtsOptsEnabled" is added into RtsFlags.MiscFlags to
tell the availablity of RTS options.

Some concerns:
* Unlike other flag fields in "libraries/base/GHC/RTS/Flags.hsc",
  "RtsOptsEnabled" is defined in "includes/RtsAPI.h" and lacks
  constant macros. Therefore In "GHC.RTS", "RtsOptsEnabled" simply
  derives Enum instance and reads as of type "CInt".

* There are other ways to change RTS options (e.g. `-with-rtsopts`),
  but it might be too verbose to mention.

Test Plan: validate

Reviewers: austin, hvr, thomie, simonmar

Reviewed By: thomie

Subscribers: thomie, rwbarton

Differential Revision: https://phabricator.haskell.org/D767

GHC Trac Issues: #9579

1 files changed, 9 insertions, 1 deletions

diff --git a/rts/hooks/StackOverflow.c b/rts/hooks/StackOverflow.c
index 1095b1b81d..1ae8603eec 100644
--- a/rts/hooks/StackOverflow.c
+++ b/rts/hooks/StackOverflow.c
@@ -7,11 +7,19 @@
 #include "PosixSource.h"
 #include "Rts.h"
 #include "Hooks.h"
+#include "RtsFlags.h"
 
 #include <stdio.h>
 
 void
 StackOverflowHook (W_ stack_size)    /* in bytes */
 {
-    fprintf(stderr, "Stack space overflow: current size %" FMT_Word " bytes.\nUse `+RTS -Ksize -RTS' to increase it.\n", stack_size);
+    fprintf(stderr,
+            "Stack space overflow: current size %" FMT_Word " bytes.\n"
+            "%s `+RTS -Ksize -RTS' to increase it.\n",
+            stack_size,
+            ((rtsConfig.rts_opts_enabled == RtsOptsAll)
+             ? "Use"
+             : "Relink with -rtsopts and use")
+            );
 }