Skip to content

doc: describe child.kill() pitfalls on linux #6052

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed

doc: describe child.kill() pitfalls on linux #6052

wants to merge 1 commit into from

Conversation

eljefedelrodeodeljefe
Copy link
Contributor

Pull Request check-list

Please make sure to review and check all of these items:

  • Does make -j8 test (UNIX) or vcbuild test nosign (Windows) pass with
    this change (including linting)?
  • Is the commit message formatted according to CONTRIBUTING.md?
  • If this change fixes a bug (or a performance problem), is a regression
    test (or a benchmark) included?
  • Is a documentation update included (if this change modifies
    existing APIs, or introduces new ones)?

Affected core subsystem(s)

doc

Description of change

This commit refines the documentation around child.kill(), where kill attempts against shells will lead to unexpected results. Namely, on linux the child process of a child process will not terminate, when its parent gets terminated. This is different across the the platforms.

closes #2098

@mscdex mscdex added child_process Issues and PRs related to the child_process subsystem. doc Issues and PRs related to the documentations. labels Apr 5, 2016
Note that while the function is called `kill`, the signal delivered to the
child process may not actually terminate the process.
child process may not actually terminate the process. E.g. on `linux` child
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Any reason why linux is inside a code segment here rather than being capitalized? (Linux)

@eljefedelrodeodeljefe
Copy link
Contributor Author

@benjamingr did the Linux thing. Thx.

@eljefedelrodeodeljefe
Copy link
Contributor Author

@sam-github Yes. And that was my point also. I have just separated it from the part above paragraph. Wasn't sure whether it was fitting in there. This was meant to clarify exactly that confusion. Hope that is better.

@benjamingr
Copy link
Member

LGTM.

@benjamingr
Copy link
Member

Thanks, landed in 8f4fdc9

@benjamingr benjamingr closed this Apr 10, 2016
stevemao referenced this pull request Apr 11, 2016
This commit refines the documentation around child.kill(), where kill
attempts against shells will lead to unexpected results. Namely, on
linux the child process of a child process will not terminate, when
its parent gets terminated. This is different across the the
platforms.

PR-URL: #2098
Reviewed-By: Benjamin Gruenbaum <[email protected]>
Closes: #2098
@eljefedelrodeodeljefe eljefedelrodeodeljefe deleted the doc/refine-child-kill branch April 14, 2016 00:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
child_process Issues and PRs related to the child_process subsystem. doc Issues and PRs related to the documentations.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

child_process.spawn sh not killable
7 participants