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 handleSYNOPSIS
cc [ flag... ] file... -lc_db [ library... ]
#include
#include
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, asreturned by thr_create(3C) or thr_self(3C). The thread han-
dle 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 associ-
ated 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
SunOS 5.11 Last change: 20 Oct 1998 1
Threads Debugging Library Functions td_ta_map_id2thr(3C_DB)
See attributes(5) for description of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| MT-Level | Safe |
|_____________________________|_____________________________|
SEE ALSO
libc_db(3LIB), thr_create(3C), thr_self(3C), attributes(5)
SunOS 5.11 Last change: 20 Oct 1998 2