Bug 126680 - sem_wait man page has bug in RETURN VALUE section
sem_wait man page has bug in RETURN VALUE section
Status: CLOSED ERRATA
Product: Red Hat Enterprise Linux 3
Classification: Red Hat
Component: man-pages (Show other bugs)
3.0
All Linux
medium Severity low
: ---
: ---
Assigned To: Ivana Varekova
Ben Levenson
:
Depends On:
Blocks:
  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:
Environment:
Last Closed: 2007-06-11 14:51:07 EDT
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)

  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
pages.
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.

http://rhn.redhat.com/errata/RHBA-2007-0408.html

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