This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Document SIGBREAK as argument for signal() under Windows.
Type: enhancement Stage: resolved
Components: Documentation, Windows Versions: Python 3.7, Python 3.6, Python 3.5
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: berker.peksag, docs@python, paul.moore, python-dev, steve.dower, tim.golden, wrwrwr, zach.ware
Priority: low Keywords: easy, patch

Created on 2016-11-18 19:38 by wrwrwr, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
sigbreak.patch wrwrwr, 2016-11-18 19:38 review
Messages (3)
msg281159 - (view) Author: Wojtek Ruszczewski (wrwrwr) * Date: 2016-11-18 19:38
SIGBREAK should be listed as acceptable for signal.signal() under Windows.

Some context. Registering a handler for SIGBREAK may be useful as this is the signal that generating CTRL_BREAK_EVENT results in (and the latter combined with the CREATE_NEW_PROCESS_GROUP flag might be the closest that one can get to terminating a process group).

Some pointers:
* The changed documentation fragment: https://docs.python.org/3/library/signal.html#signal.signal.
* MSDN doesn't say so much about SIGBREAK: https://msdn.microsoft.com/en-us/library/windows/desktop/ms682541(v=vs.85).aspx.
* SIGBREAK was added to the signal module with #466877.
* The signal number check looks as follows: https://github.com/python/cpython/blob/3.6/Modules/signalmodule.c#L402.
msg281729 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2016-11-25 16:47
New changeset dddce0f539dd by Berker Peksag in branch '3.5':
Issue #28738: Document SIGBREAK as an acceptable value on Windows
https://hg.python.org/cpython/rev/dddce0f539dd

New changeset 43856eb83dc1 by Berker Peksag in branch '3.6':
Issue #28738: Merge from 3.6
https://hg.python.org/cpython/rev/43856eb83dc1

New changeset 04eba322be92 by Berker Peksag in branch 'default':
Issue #28738: Merge from 3.6
https://hg.python.org/cpython/rev/04eba322be92
msg281730 - (view) Author: Berker Peksag (berker.peksag) * (Python committer) Date: 2016-11-25 16:48
Thanks for the report and for the patch, Wojtek!
History
Date User Action Args
2022-04-11 14:58:39adminsetgithub: 72924
2016-11-25 16:48:31berker.peksagsetstatus: open -> closed

versions: + Python 3.5
nosy: + berker.peksag

messages: + msg281730
resolution: fixed
stage: patch review -> resolved
2016-11-25 16:47:51python-devsetnosy: + python-dev
messages: + msg281729
2016-11-22 01:39:22eryksunsetkeywords: + easy
priority: normal -> low
stage: patch review
versions: + Python 3.6
2016-11-18 19:38:36wrwrwrcreate