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)
