Commit 13c3924
doc: add Windows-specific info to subprocess.kill()
Clarify the inner workings of .kill on Windows,
since termination signals are not available there.
Fixes: #34858
PR-URL: #34867
Reviewed-By: Juan José Arboleda <soyjuanarbol@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>1 parent 570fbce commit 13c3924
1 file changed
Lines changed: 6 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -1277,6 +1277,11 @@ may not actually terminate the process. | |||
| 1277 | 1277 | ||
| 1278 | 1278 | See kill(2) for reference. | |
| 1279 | 1279 | ||
| 1280 | + On Windows, where POSIX signals do not exist, the `signal` argument will be | ||
| 1281 | + ignored, and the process will be killed forcefully and abruptly (similar to | ||
| 1282 | + `'SIGKILL'`). | ||
| 1283 | + See [Signal Events][] for more details. | ||
| 1284 | + | ||
| 1280 | 1285 | On Linux, child processes of child processes will not be terminated | |
| 1281 | 1286 | when attempting to kill their parent. This is likely to happen when running a | |
| 1282 | 1287 | new process in a shell or with the use of the `shell` option of `ChildProcess`: | |
@@ -1741,6 +1746,7 @@ or [`child_process.fork()`][]. | |||
| 1741 | 1746 | [Default Windows shell]: #child_process_default_windows_shell | |
| 1742 | 1747 | [HTML structured clone algorithm]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm | |
| 1743 | 1748 | [Shell requirements]: #child_process_shell_requirements | |
| 1749 | + [Signal Events]: process.md#process_signal_events | ||
| 1744 | 1750 | [`'disconnect'`]: process.md#process_event_disconnect | |
| 1745 | 1751 | [`'error'`]: #child_process_event_error | |
| 1746 | 1752 | [`'exit'`]: #child_process_event_exit | |
0 commit comments