[1003.1(2008)/Issue 7 0000092]: pthread_mutex_lock return

[Austin Group Bug Tracker <noreply@xxxxxxxxxxxxx>]

The following issue has been UPDATED. 
====================================================================== 
http://austingroupbugs.net/view.php?id=92 
====================================================================== 
Reported By:                geoffclare
Assigned To:                ajosey
====================================================================== 
Project:                    1003.1(2008)/Issue 7
Issue ID:                   92
Category:                   System Interfaces
Type:                       Error
Severity:                   Objection
Priority:                   normal
Status:                     Resolved
Name:                       Geoff Clare 
Organization:               The Open Group 
User Reference:              
Section:                    pthread_mutex_lock 
Page Number:                1639 
Line Number:                52741 
Final Accepted Text:         
Resolution:                 Accepted
Fixed in Version:           
====================================================================== 
Date Submitted:             2009-06-29 19:59 UTC
Last Modified:              2009-07-01 17:57 UTC
====================================================================== 
Summary:                    pthread_mutex_lock return
Description: 
 _____________________________________________________________________________
 OBJECTION                                        Enhancement Request
Number 22
 gwc:xxxxxxxxxxxxx                 Defect in XSH pthread_mutex_lock (rdvk#
 3)
 [gwc pmtl return]                              Fri, 9 Jan 2009 15:53:20
+0000

_____________________________________________________________________________

The RETURN VALUE section on the pthread_mutex_lock() page states:

     "The pthread_mutex_trylock() function shall return zero if a lock
     on the mutex object referenced by mutex is acquired. Otherwise, an
     error number is returned to indicate the error."

 This conflicts with the description of the EOWNERDEAD error for
 pthread_mutex_trylock() which says "The mutex lock shall be acquired
 by the calling thread".

Desired Action: 
On line 52739 (1st line of RETURN VALUE) change

     "pthread_mutex_lock() and pthread_mutex_unlock()"

 to

     "pthread_mutex_lock(), pthread_mutex_trylock() and
pthread_mutex_unlock()"

 Delete lines 52741-52742 (2nd para of RETURN VALUE).
======================================================================