Bugzilla will be upgraded to version 5.0 on a still to be determined date in the near future. The original upgrade date has been delayed.
Bug 126680 - sem_wait man page has bug in RETURN VALUE section
sem_wait man page has bug in RETURN VALUE section
Product: Red Hat Enterprise Linux 3
Classification: Red Hat
Component: man-pages (Show other bugs)
All Linux
medium Severity low
: ---
: ---
Assigned To: Ivana Varekova
Ben Levenson
Depends On:
  Show dependency treegraph
Reported: 2004-06-24 13:14 EDT by Corinna Vinschen
Modified: 2007-11-30 17:07 EST (History)
2 users (show)

See Also:
Fixed In Version: RHBA-2007-0408
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Last Closed: 2007-06-11 14:51:07 EDT
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)

External Trackers
Tracker ID Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2007:0408 normal SHIPPED_LIVE man-pages bug fix update 2007-06-07 15:20:53 EDT

  None (edit)
Description Corinna Vinschen 2004-06-24 13:14:02 EDT
The sem_wait(3) man page states that sem_wait and sem_trywait
always return 0.  That's not correct.  The Opengroup man pages
allow -1 as return value with errno set.  This can happen on
RHEL 3 as well, e. g. when running an application under GDB
and pthread_create is called while another thread is waiting
in a sem_wait call.  In that case, sem_wait returns -1 and
errno set to EINTR.
Comment 1 Eido Inoue 2004-08-20 15:22:56 EDT
man page part of glibc-devel.

fyi, the posix version (man 3p), which is part of man-pages, has the
correct return value.
Comment 2 Ulrich Drepper 2004-09-30 04:38:33 EDT
The LinuxThreads implementation always returns 0 and this is what the
man page documents.

The NPTL implementation is different.  Just another reason why the man
page should move to man-pages, it must be independent.

Adrian, do you want to copy the pages, edit and distribute them?  This
need to be coordinated with Jakub stopping to distribute them.
Comment 3 Ulrich Drepper 2004-09-30 04:39:29 EDT
Ugh, Andrian wasn't cc:ed.  See comment #2.
Comment 4 Eido Inoue 2004-09-30 16:12:21 EDT
comment 2: sure, i'll put them in.

however, we'll need non-english versions as well to go in all the man
Comment 5 Ulrich Drepper 2004-09-30 17:09:45 EDT
Reassigning to man-pages.

The files are in the glibc sources or, if you prefer, packaged in
~drepper/thread-man-pages.tar.bz2 on devserv.

If you need help with making the changes requested in this bug, please
let me.  Also let Jakub know which man-pages RPM will contain the new
pages so that the glibc RPM stops distributing them.
Comment 12 Red Hat Bugzilla 2007-06-11 14:51:09 EDT
An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on the solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.


Note You need to log in before you can comment on or make changes to this bug.