Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
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

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.