New submission from John Marshall <jmarsh...@hey.com>:

<https://docs.python.org/3.11/library/multiprocessing.html#multiprocessing.Process.exitcode>
 describes exitcode as

"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."

and similarly in earlier documentation versions.

This does not describe what the exit code will be under normal circumstances, 
or if the child abends by raising a Python exception.

By examination of BaseProcess._bootstrap() it can be determined that the 
current behaviour appears to be:

* even if your subclass overrides the run() method, whatever this method 
returns is ignored (and in particular the return value has no effect on the 
child's exit code);

* if the run() method returns normally, the child's exit code will be 0;

* if the run() method raises SystemExit (or, I guess, calls sys.exit()) with an 
integer exit status, that exit status will be propagated to the child's exit 
code;

* if the run() method raises any other exception, the exception traceback will 
be printed to stderr and the child's exit code will be 1.


However I did not see a way to figure these details out from the documentation, 
and it is unclear whether all these details are supported behaviours.

----------
assignee: docs@python
components: Documentation
messages: 404597
nosy: docs@python, jmarshall
priority: normal
severity: normal
status: open
title: multiprocessing exitcode is insufficiently documented
type: behavior

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue45554>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to