From 0be4760d85399a308421d9229b5d7f1b4ec718a2 Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Tue, 18 Jan 2022 14:03:22 -0800 Subject: [3.9] bpo-45554: Document multiprocessing.Process.exitcode values (GH-30142) (GH-30675) This addresses [[bpo-45554]()]() by expanding the `exitcode` documentation to also describe what `exitcode` will be in cases of normal termination, `sys.exit()` called, and on uncaught exceptions. (cherry picked from commit 3852269b91fcc8ee668cd876b3669eba6da5b1ac) Co-authored-by: John Marshall --- Doc/library/multiprocessing.rst | 11 +++++++++-- Misc/ACKS | 1 + 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst index 96bc6c1..4966be3 100644 --- a/Doc/library/multiprocessing.rst +++ b/Doc/library/multiprocessing.rst @@ -569,8 +569,15 @@ The :mod:`multiprocessing` package mostly replicates the API of the .. attribute:: exitcode The child's exit code. This will be ``None`` if the process has not yet - terminated. A negative value *-N* indicates that the child was terminated - by signal *N*. + terminated. + + If the child's :meth:`run` method returned normally, the exit code + will be 0. If it terminated via :func:`sys.exit` with an integer + argument *N*, the exit code will be *N*. + + If the child terminated due to an exception not caught within + :meth:`run`, the exit code will be 1. If it was terminated by + signal *N*, the exit code will be the negative value *-N*. .. attribute:: authkey diff --git a/Misc/ACKS b/Misc/ACKS index ac893ac..25c8865 100644 --- a/Misc/ACKS +++ b/Misc/ACKS @@ -1095,6 +1095,7 @@ Vincent Marchetti David Marek Doug Marien Sven Marnach +John Marshall Alex Martelli Dennis Mårtensson Anthony Martin -- cgit v0.12