New: pthread_kill() should describe it may cause SEGV when target thread doesn't exist
https://bugzilla.kernel.org/show_bug.cgi?id=53061
Summary: pthread_kill() should describe it may cause SEGV when
target thread doesn't exist
Product: Documentation
Version: unspecified
Platform: All
OS/Version: Linux
Tree: Mainline
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
AssignedTo: documentation_man-pages-ztI5WcYan/[email protected]
ReportedBy: [email protected]
Regression: No
Now, pthrad_kill() man page have following explanation.
http://man7.org/linux/man-pages/man3/pthread_kill.3.html
Quoted 5 lines
ERRORS
EINVAL An invalid signal was specified.
ESRCH No thread with the ID thread could be found.
But it is misleading. Current implementation cause SEGV when no thread ID exist highly likely.
As suggested Rich on libc-alpha
(http://permalink.gmane.org/gmane.comp.lib.glibc.alpha/28919).
it would be nice if the man page point to following POSIX sentence.
POSIX XSH 2.9.2:
"The lifetime of a thread ID ends after the thread terminates if it was created with the detachstate attribute set to PTHREAD_CREATE_DETACHED or if pthread_detach() or pthread_join() has been called for that thread. A conforming implementation is free to reuse a thread ID after its lifetime has ended. If an application attempts to use a thread ID whose lifetime has ended, the behavior is undefined."
Signature · 7 lines
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
A message that is not in the archive (sent off-list or not yet received): bug-53061-11311-3bo0kxnWaOQUvHkbgXJLS5sdmw4N0Rt+2LY78lusg7I@public.gmane.org/
[Bug 53061] pthread_kill() should describe it may cause SEGV when target thread doesn't exist
https://bugzilla.kernel.org/show_bug.cgi?id=53061
Michael Kerrisk <[email protected]> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |RESOLVED
CC| |[email protected]
Resolution|--- |CODE_FIX--- Comment #1 from Michael Kerrisk <[email protected]> --- The pthreads(7) page now carries this text:
[[
The system may reuse a thread ID after a terminated thread has been joined, or a detached thread has terminated.
POSIX says: "If an application attempts to use a thread ID whose lifetime has ended, the behavior is undefined."
]]
I think that more or less satisfies your request, so I'm closing this bug.
Thanks for the report.
Signature · 6 lines
You are receiving this mail because: You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html