TD_TA_MAP_ADDR2SYNC(3C_DB)TD_TA_MAP_ADDR2SYNC(3C_DB)NAMEtd_ta_map_addr2sync - get a synchronization object handle from a syn‐
chronization 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 ALSOlibc_db(3LIB), attributes(5)
Oct 20, 1998 TD_TA_MAP_ADDR2SYNC(3C_DB)