Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for td_ta_map_id2thr (opensolaris section 3cdb)

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.11 20 Oct 1998 td_ta_map_id2thr(3C_DB)