Skip to content

Commit 9dabc43

Browse files
committed
Deprecate sending the shutdown_request message on the shell channel.
In conversation with @minrk, we decided shutdown messages should always be treated with a higher priority, and it was confusing to have them sent on either channel.
1 parent 49aabf9 commit 9dabc43

File tree

1 file changed

+7
-2
lines changed

1 file changed

+7
-2
lines changed

docs/messaging.rst

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -943,8 +943,7 @@ multiple cases:
943943

944944
The client sends a shutdown request to the kernel, and once it receives the
945945
reply message (which is otherwise empty), it can assume that the kernel has
946-
completed shutdown safely. The request can be sent on either the `control` or
947-
`shell` channels.
946+
completed shutdown safely. The request is sent on the `control` channel.
948947

949948
Upon their own shutdown, client applications will typically execute a last
950949
minute sanity check and forcefully terminate any kernel that is still alive, to
@@ -968,6 +967,12 @@ Message type: ``shutdown_reply``::
968967
socket, they simply send a forceful process termination signal, since a dead
969968
process is unlikely to respond in any useful way to messages.
970969

970+
.. versionchanged:: 5.4
971+
972+
Sending a ``shutdown_request`` message on the ``shell`` channel is deprecated.
973+
974+
975+
971976
.. _msging_interrupt:
972977

973978
Kernel interrupt

0 commit comments

Comments
 (0)