td_ta_map_id2thr(3C_DB) 				Threads Debugging Library Functions				   td_ta_map_id2thr(3C_DB)

NAME

       td_ta_map_id2thr, td_ta_map_lwp2thr - convert a thread ID or LWP ID to a thread handle

SYNOPSIS

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

       The  td_ta_map_id2thr()	function  produces  the  td_thrhandle_t  thread  handle that corresponds to a particular thread ID, as returned by
       thr_create(3C) or thr_self(3C). The thread handle is returned in *th_p.

       The td_ta_map_lwp2thr() function produces the td_thrhandle_t thread handle 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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       libc_db(3LIB), thr_create(3C), thr_self(3C), attributes(5)

SunOS 5.10							    20 Oct 1998 					   td_ta_map_id2thr(3C_DB)