td_ta_map_id2thr(3C_DBThreads Debugging Library Functiotd_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_thrhan‐
dle_t *th_p);
DESCRIPTION
The td_ta_map_id2thr() function produces the td_thrhandle_t thread han‐
dle that corresponds to a particular thread ID, as returned by thr_cre‐
ate(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 ALSOlibc_db(3LIB), thr_create(3C), thr_self(3C), attributes(5)SunOS 5.10 20 Oct 1998 td_ta_map_id2thr(3C_DB)
