[1003.1(2008)/Issue 7 0000100]: dlsym return on success

[Austin Group Bug Tracker <noreply@xxxxxxxxxxxxx>]

The following issue has been REOPENED. 
====================================================================== 
http://austingroupbugs.net/view.php?id=100 
====================================================================== 
Reported By:                geoffclare
Assigned To:                ajosey
====================================================================== 
Project:                    1003.1(2008)/Issue 7
Issue ID:                   100
Category:                   System Interfaces
Type:                       Omission
Severity:                   Editorial
Priority:                   normal
Status:                     Under Review
Name:                       Geoff Clare 
Organization:               The Open Group 
User Reference:              
Section:                    dlsym 
Page Number:                735 
Line Number:                24705 
Final Accepted Text:         
====================================================================== 
Date Submitted:             2009-06-29 20:22 UTC
Last Modified:              2009-07-02 15:48 UTC
====================================================================== 
Summary:                    dlsym return on success
Description: 
_____________________________________________________________________________
 EDITORIAL                                        Enhancement Request
Number 30
 gwc:xxxxxxxxxxxxx                              Defect in XSH dlsym (rdvk#
 1)
 [gwc dlsym return on success]                  Wed, 8 Apr 2009 09:43:51
+0100

_____________________________________________________________________________

 The RETURN VALUE section on the dlsym() page does not state what
 the function returns on success, only on failure.
Desired Action: 
Insert

     "Upon successful completion, dlsym() shall return the address of
     the named symbol."

 before

     "If handle does not refer ..."
====================================================================== 

---------------------------------------------------------------------- 
 (0000148) geoffclare (reporter) - 2009-07-02 15:48
 http://austingroupbugs.net/view.php?id=100#c148 
---------------------------------------------------------------------- 
In view of the recent discussion of XSH 2.12.3, I think that it would
be a good idea to mention functions explicitly in the dlsym()
RETURN VALUE section.

I suggest that instead of inserting the text proposed in the
Desired Action, we should instead insert:

    "Upon successful completion, if the named symbol refers to a
    function, dlsym() shall return the address of the function
    converted from type pointer to function to type pointer to
    void, otherwise dlsym() shall return the address of the named
    symbol."