Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Threads Library Functionstd_ta_map_addr2sync(3THR)


NAME

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

SYNOPSIS

 
cc [ flag ... ] file ... -lthread_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

 

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 TYPEATTRIBUTE VALUE
MT-LevelSafe

SEE ALSO

 

libthread_db(3THR), libthread_db(3LIB), attributes(5)



SunOS 5.9Go To TopLast Changed 20 Oct 1998