https://github.com/python/cpython/commit/8a531f89df8f8bf4c4fe395f9edcdc19852bdf1c commit: 8a531f89df8f8bf4c4fe395f9edcdc19852bdf1c branch: main author: andreuu-tsai <[email protected]> committer: kumaraditya303 <[email protected]> date: 2026-03-21T12:32:28Z summary:
gh-138234: clarify returncode behavior for subprocesses created with `shell=True` (#138536) Co-authored-by: Kumar Aditya <[email protected]> files: M Doc/library/asyncio-subprocess.rst M Doc/library/subprocess.rst diff --git a/Doc/library/asyncio-subprocess.rst b/Doc/library/asyncio-subprocess.rst index 9416c758e51d95..cb9ddc08a64d9b 100644 --- a/Doc/library/asyncio-subprocess.rst +++ b/Doc/library/asyncio-subprocess.rst @@ -311,8 +311,16 @@ their completion. A ``None`` value indicates that the process has not terminated yet. - A negative value ``-N`` indicates that the child was terminated - by signal ``N`` (POSIX only). + For processes created with :func:`~asyncio.create_subprocess_exec`, a negative + value ``-N`` indicates that the child was terminated by signal ``N`` + (POSIX only). + + For processes created with :func:`~asyncio.create_subprocess_shell`, the + return code reflects the exit status of the shell itself (e.g. ``/bin/sh``), + which may map signals to codes such as ``128+N``. See the + documentation of the shell (for example, the Bash manual's Exit Status) + for details. + .. _asyncio-subprocess-threads: diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst index def6d58eabbeee..9e261a0ca03902 100644 --- a/Doc/library/subprocess.rst +++ b/Doc/library/subprocess.rst @@ -964,6 +964,11 @@ Reassigning them to new values is unsupported: A negative value ``-N`` indicates that the child was terminated by signal ``N`` (POSIX only). + When ``shell=True``, the return code reflects the exit status of the shell + itself (e.g. ``/bin/sh``), which may map signals to codes such as + ``128+N``. See the documentation of the shell (for example, the Bash + manual's Exit Status) for details. + Windows Popen Helpers --------------------- _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3//lists/python-checkins.python.org Member address: [email protected]
