Threads Library Functions                  td_ta_map_id2thr(3THR)

NAME
     td_ta_map_id2thr, td_ta_map_lwp2thr - convert a thread id or
     LWP id to a thread handle

SYNOPSIS
     cc [ flag ... ] file ... -lthread_db [ library ... ]

     #include <proc_service.h>
     #include <thread_db.h>

     td_ta_map_id2thr(const   td_thragent_t    *ta_p,    thread_t
     tid,td_thrhandle_t *th_p);

     td_ta_map_lwp2thr(const   td_thragent_t    *ta_p,    lwpid_t
     lwpid,td_thrhandle_t *th_p);

DESCRIPTION
     td_ta_map_id2thr() produces the  td_thrhandle_t thread  han-
     dle  that corresponds to a particular thread id, as returned
     by thr_create(3THR) or  thr_self(3THR).  The  thread  handle
     is returned in *th_p.

     td_ta_map_lwp2thr() produces the  td_thrhandle_t thread han-
     dle  for the thread that is currently executing on the light
     weight process ( LWP) and has an id of lwpid.

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_DBERR
           A call to  one  of  the  imported  interface  routines
           failed.

     TD_NOTHR
           Either there is no thread with the given thread id   (
           td_ta_map_id2thr)  or no thread is currently executing
           on the given  LWP ( td_ta_map_lwp2thr).

     TD_ERR
           The call did not complete successfully.

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_id2thr(3THR)

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

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

SunOS 5.8           Last change: 20 Oct 1998                    2