td_ta_map_addr2sync(3T)

NAME

td_ta_map_addr2sync − get a synchronization object handle from a synchronization object’s address

SYNOPSIS

cc [ flag ... ] file ... /lib/libthread_db.so.1 [ 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

td_ta_map_addr2sync() 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 in.

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

TD_BADSH sh_p 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 libthread_db internal error occurred.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
MT-Level	Safe

Museum