diff --git a/docs/src/main/asciidoc/native-reference.adoc b/docs/src/main/asciidoc/native-reference.adoc index c5f8f2f83dcbb..1742702c3bec6 100644 --- a/docs/src/main/asciidoc/native-reference.adoc +++ b/docs/src/main/asciidoc/native-reference.adoc @@ -2301,6 +2301,19 @@ com.oracle.svm.core.VM=GraalVM 22.0.0.2-Final Java 11 Mandrel Distribution See <> for details. +=== Can I get a thread dump of a native executable? + +Yes, Quarkus sets up a signal handler for the `SIGQUIT` signal (or `SIGBREAK` on windows) that will result in a thread +dump being printed when receiving the `SIGQUIT/SIGBREAK` signal. +You may use `kill -SIGQUIT ` to trigger a thread dump. + +[NOTE] +==== +Quarkus uses its own signal handler, to use GraalVM's default signal handler instead you will need to: +1. Add `-H:+DumpThreadStacksOnSignal` to `quarkus.native.additional-build-args` and rebuild the application. +2. Set the environment variable `DISABLE_SIGNAL_HANDLERS` before running the app. +==== + [[heap-dumps]] === Can I get a heap dump of a native executable? e.g. if it runs out of memory