Threads Library Functions               td_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  attri-
     butes:

SunOS 5.8           Last change: 20 Oct 1998                    1

Threads Library Functions               td_ta_map_addr2sync(3THR)

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|

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

SunOS 5.8           Last change: 20 Oct 1998                    2