[GR-24622] Show stacktrace on SIGQUIT on Native Image for the truffleruby launcher.

PullRequest: truffleruby/1755

Author: eregon

CHANGELOG.md

@@ -11,6 +11,7 @@ New features:
 * Add basic support for Linux ARM64.
 * `foreign_object.name = value` will now call `Interoplibrary#writeMember("name", value)` instead of `invokeMember("name=", value)`.
 * Always show the Ruby core library files in backtraces (#1414).
+* The Java stacktrace is now shown when sending SIGQUIT to the process, also on TruffleRuby Native, see [Debugging](doc/user/debugging.md) for details (#2041).
 
 Bug fixes:
 

doc/user/debugging.md

@@ -14,6 +14,17 @@ Java exceptions can be printed with `--exceptions-print-uncaught-java` or
 
 See other `--backtraces-*` and `--exceptions-*` options for more possibilities.
 
+## Printing Stacktraces and Backtraces of a running Process
+
+One can send the `SIGQUIT` signal to TruffleRuby to make it print the Java stacktraces of all threads.
+`Ctrl + \ ` can be used to send `SIGQUIT` to the current process in a terminal.
+This is useful to debug hangs, deadlocks or know what the process is doing.
+This works on both TruffleRuby Native and JVM.
+
+Sending `SIGALRM` to a TruffleRuby process will print the Ruby backtraces of all threads.
+Note that printing the Ruby backtraces of all threads significantly lowers
+performance, so it should only be used for debugging.
+
 ## More Information in Backtraces
 
 We try to match MRI's backtrace format as closely as possible. This sometimes means

mx.truffleruby/mx_truffleruby.py

@@ -219,6 +219,7 @@ def verify_ci(args):
             jar_distributions=['truffleruby:TRUFFLERUBY-LAUNCHER'],
             main_class='org.truffleruby.launcher.RubyLauncher',
             build_args=[
+                '-H:+DumpThreadStacksOnSignal',
                 '-H:+DetectUserDirectoriesInImageHeap',
                 '-H:+TruffleCheckBlackListedMethods',
             ],

mx.truffleruby/suite.py

@@ -7,7 +7,7 @@
             {
                 "name": "sulong",
                 "subdir": True,
-                "version": "89aaf872689d47977073e0b87f7e12c8f28bc44e",
+                "version": "8b8603b39b55288db5e23750066efbd6d52ee2db",
                 "urls": [
                     {"url": "https://github.com/oracle/graal.git", "kind": "git"},
                     {"url": "https://curio.ssw.jku.at/nexus/content/repositories/snapshots", "kind": "binary"},