signal.SIGCLD alias is not available on OSX

[tacaswell]

BPO	45251
Nosy	@ronaldoussoren, @ned-deily, @tacaswell
Files	osx_signal_compat.patch

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = None
created_at = <Date 2021-09-20.22:27:22.221>
labels = ['OS-mac', '3.9', '3.10', '3.11', 'library', 'docs']
title = 'signal.SIGCLD alias is not available on OSX'
updated_at = <Date 2021-09-24.23:40:59.307>
user = 'https://github.com/tacaswell'

bugs.python.org fields:

activity = <Date 2021-09-24.23:40:59.307>
actor = 'terry.reedy'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation', 'Library (Lib)', 'macOS']
creation = <Date 2021-09-20.22:27:22.221>
creator = 'tcaswell'
dependencies = []
files = ['50290']
hgrepos = []
issue_num = 45251
keywords = ['patch']
message_count = 2.0
messages = ['402280', '402292']
nosy_count = 4.0
nosy_names = ['ronaldoussoren', 'ned.deily', 'docs@python', 'tcaswell']
pr_nums = []
priority = 'normal'
resolution = None
stage = None
status = 'open'
superseder = None
type = None
url = 'https://bugs.python.org/issue45251'
versions = ['Python 3.9', 'Python 3.10', 'Python 3.11']

Linked PRs

• gh-89414: Document that SIGCLD is not available on macOS #113580
• [3.12] gh-89414: Document that SIGCLD is not available on macOS (GH-113580) #113585
• [3.11] gh-89414: Document that SIGCLD is not available on macOS (GH-113580) #113586

[tacaswell]

The module attribute signal.SIGCLD (https://docs.python.org/3/library/signal.html#signal.SIGCLD) is an "archaic" (quoting from the GNU C Library source) alias for signal.SIGCHLD (https://docs.python.org/3/library/signal.html#signal.SIGCHLD). signal.SIGCHLD is documented as being available on unix, and signal.SIGCLD is documented as an alias of signal.SIGCHLD.

However, it seems that clang does not define the SIGCLD back-compatibility name [1] so the SIGCLD alias is missing on OSX (all the way to at least 2.7) because the clang headers appear to not define the SIGCLD macro and hence the logic in modulesignal.c does not find it, and hence the rest of the tooling in signal.py does not find it.

I am not sure if the correct fix is to document that SIGCLD in only available on linux (which I am not sure is completely correct, maybe "availability is platform dependent, but definitely not on darwin"?) or to add the macro if SIGCHLD is defined and SIGCLD is missing (see attached patch)

[1] SIGCLD is not documented in https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man3/signal.3.html and not the signal.h that ships with xcode