Red Hat Bugzilla – Bug 194089
tgkill(2) tgid of -1 is described contrarily in tkill(2) and tgkill(2) man pages
Last modified: 2008-05-06 17:06:41 EDT
Description of problem:
tgkill is documented in the tkill(2) and tgkill(2) man pages inconsistantly.
The man page for tkill(2) states:
The tgkill() call improves on tkill() by allowing the caller to specify
the thread group ID of the thread to be signalled, protecting against
TID reuse. If the tgid is specified as -1, tgkill() degenerates into
But the man page for tgkill(2) states:
tgkill returns this error if pid or tgid are less than zero.
This call is only valid for single tasks.
Testing the call with a tgid of -1 shows it does return -1 with errno set to
Version-Release number of selected component (if applicable):
All, tested on 2.6.16-1.2122_FC5 for x86.
Call the tgkill syscall with a tgid of -1.
Steps to Reproduce:
1. Call the tgkill() syscall with a tgid of -1
2. Watch it return -1 and set errno to EINVAL
Call returns -1 with errno set to EINVAL.
Correct according to the tgkill(2) man page, incorrect behavior according
to the tkill(2) man page.
It needs to be determined whether the syscall should work as documented in
tkill(2) or tgkill(2) and the documentation modified accordingly. If the
documentation for tkill(2) is to be followed, the syscall needs to be modified
to support the documented method of operation and the man page for tgkill(2)
should be corrected.
If this is determined to be a documentation bug only, the "component" field
should be changed, but ONLY after determining that it is the tkill(2) man page
that is incorrect.
A new kernel update has been released (Version: 2.6.18-1.2200.fc5)
based upon a new upstream kernel release.
Please retest against this new kernel, as a large number of patches
go into each upstream release, possibly including changes that
may address this problem.
This bug has been placed in NEEDINFO state.
Due to the large volume of inactive bugs in bugzilla, if this bug is
still in this state in two weeks time, it will be closed.
Should this bug still be relevant after this period, the reporter
can reopen the bug at any time. Any other users on the Cc: list
of this bug can request that the bug be reopened by adding a
comment to the bug.
In the last few updates, some users upgrading from FC4->FC5
have reported that installing a kernel update has left their
systems unbootable. If you have been affected by this problem
please check you only have one version of device-mapper & lvm2
installed. See bug 207474 for further details.
If this bug is a problem preventing you from installing the
release this version is filed against, please see bug 169613.
If this bug has been fixed, but you are now experiencing a different
problem, please file a separate bug for the new problem.
The discrepancy in documentation still exists today, and this program still
returns EINVAL run against 2.6.18-1.2200.fc5smp:
if (syscall(SYS_tgkill, -1, getpid(), 9) < 0)
This is also a bug in RHEL5 Beta2
Fedora apologizes that these issues have not been resolved yet. We're
sorry it's taken so long for your bug to be properly triaged and acted
on. We appreciate the time you took to report this issue and want to
make sure no important bugs slip through the cracks.
If you're currently running a version of Fedora Core between 1 and 6,
please note that Fedora no longer maintains these releases. We strongly
encourage you to upgrade to a current Fedora release. In order to
refocus our efforts as a project we are flagging all of the open bugs
for releases which are no longer maintained and closing them.
If this bug is still open against Fedora Core 1 through 6, thirty days
from now, it will be closed 'WONTFIX'. If you can reporduce this bug in
the latest Fedora version, please change to the respective version. If
you are unable to do this, please add a comment to this bug requesting
Thanks for your help, and we apologize again that we haven't handled
these issues to this point.
The process we are following is outlined here:
We will be following the process here:
http://fedoraproject.org/wiki/BugZappers/HouseKeeping to ensure this
doesn't happen again.
And if you'd like to join the bug triage team to help make things
better, check out http://fedoraproject.org/wiki/BugZappers
This bug is open for a Fedora version that is no longer maintained and
will not be fixed by Fedora. Therefore we are closing this bug.
If you can reproduce this bug against a currently maintained version of
Fedora please feel free to reopen thus bug against that version.
Thank you for reporting this bug and we are sorry it could not be fixed.
The man page for tkill(2) has been modified such that it no longer references
tgkill(2), resolving the discrepancy.