opensolaris man page for td_ta_map_addr2sync

td_ta_map_addr2sync(3C_DB)				Threads Debugging Library Functions				td_ta_map_addr2sync(3C_DB)

NAME
       td_ta_map_addr2sync - get a synchronization object handle from a synchronization object's address

SYNOPSIS
       cc [ flag... ] file... -lc_db [ library... ]
       #include <proc_service.h>
       #include <thread_db.h>

       td_ta_map_addr2sync(const td_thragent_t *ta_p, psaddr_t addr, td_synchandle_t *sh_p);

DESCRIPTION
       The  td_ta_map_addr2sync()  function  produces the synchronization object handle of type td_synchandle_t that corresponds to the address of
       the synchronization object (mutex, semaphore, condition variable, or reader/writer lock). Some effort is made to validate addr  and  verify
       that it does indeed point at a synchronization object. The handle is returned in *sh_p.

RETURN VALUES
       TD_OK	    The call completed successfully.

       TD_BADTA     An invalid internal process handle was passed.

       TD_BADPH     There is a NULL external process handle associated with this internal process handle.

       TD_BADSH     The sh_p argument is  NULL or addr does not appear to point to a valid synchronization object.

       TD_DBERR     A call to one of the imported interface routines failed.

       TD_ERR	    addr is  NULL, or a libc_db internal error occurred.

ATTRIBUTES
       See attributes(5) for description of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       libc_db(3LIB), attributes(5)

SunOS 5.11							    20 Oct 1998 					td_ta_map_addr2sync(3C_DB)