From d6a99f67d873ed6808b1297c90c4aad5ebc75902 Mon Sep 17 00:00:00 2001 From: Roland Kuhn Date: Wed, 9 Mar 2016 22:34:19 +0100 Subject: [PATCH] document ActorSystem shutdown needed in REPL, #15314 --- akka-docs/rst/additional/faq.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/akka-docs/rst/additional/faq.rst b/akka-docs/rst/additional/faq.rst index 089ea42d59..d53754e747 100644 --- a/akka-docs/rst/additional/faq.rst +++ b/akka-docs/rst/additional/faq.rst @@ -37,6 +37,16 @@ you have a matching ``stop``, ``terminate``, or ``shutdown`` call implemented. In particular you typically want to bind such values to immutable references, i.e. ``final ActorSystem system`` in Java or ``val system: ActorSystem`` in Scala. +JVM application or Scala REPL “hanging” +--------------------------------------- + +Due to an ActorSystem’s explicit lifecycle the JVM will not exit until it is stopped. +Therefore it is necessary to shutdown all ActorSystems within a running application or +Scala REPL session in order to allow these processes to terminate. + +Shutting down an ActorSystem will properly terminate all Actors and ActorMaterializers +that were created within it. + Actors in General ^^^^^^^^^^^^^^^^^