td_ta_map_id2thr(3T)

NAME

td_ta_map_id2thr, td_ta_map_lwp2thr − convert a thread id or LWP id to a thread handle

SYNOPSIS

cc [ flag ... ] file ... /lib/libthread_db.so.1 [ 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 handle that corresponds to a particular thread id, as returned by thr_create(3T) or thr_self(3T). The thread handle is returned in ∗th_p.

td_ta_map_lwp2thr() 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

Museum