man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2014
 
 

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)