Content-type: text/html Man page of td_ta_map_id2thr

td_ta_map_id2thr

Section: Threads Debugging Library Functions (3C_DB)
Updated: 20 Oct 1998
Index Return to Main Contents
 

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 TYPEATTRIBUTE VALUE
MT-LevelSafe

 

SEE ALSO

libc_db(3LIB), thr_create(3C), thr_self(3C), attributes(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:03 GMT, October 02, 2010