1td_ta_map_id2thr(3C_DB)Threads Debugging Library Functiontsd_ta_map_id2thr(3C_DB)
2
3
4

NAME

6       td_ta_map_id2thr,  td_ta_map_lwp2thr - convert a thread ID or LWP ID to
7       a thread handle
8

SYNOPSIS

10       cc [ flag... ] file... -lc_db [ library... ]
11       #include <proc_service.h>
12       #include <thread_db.h>
13
14       td_ta_map_id2thr(const td_thragent_t *ta_p, thread_t tid,td_thrhandle_t *th_p);
15
16
17       td_ta_map_lwp2thr(const td_thragent_t *ta_p, lwpid_t lwpid,td_thrhandle_t *th_p);
18
19

DESCRIPTION

21       The td_ta_map_id2thr() function produces the td_thrhandle_t thread han‐
22       dle that corresponds to a particular thread ID, as returned by thr_cre‐
23       ate(3C) or thr_self(3C). The thread handle is returned in *th_p.
24
25
26       The td_ta_map_lwp2thr() function  produces  the  td_thrhandle_t  thread
27       handle  for  the thread that is currently executing on the light weight
28       process ( LWP) and has an ID of lwpid.
29

RETURN VALUES

31       TD_OK       The call completed successfully.
32
33
34       TD_BADTA    An invalid internal process handle was passed in.
35
36
37       TD_BADPH    There is a  NULL external process  handle  associated  with
38                   this internal process handle.
39
40
41       TD_DBERR    A call to one of the imported interface routines failed.
42
43
44       TD_NOTHR    Either  there  is  no  thread  with  the  given thread ID (
45                   td_ta_map_id2thr) or no thread is  currently  executing  on
46                   the given LWP ( td_ta_map_lwp2thr).
47
48
49       TD_ERR      The call did not complete successfully.
50
51

ATTRIBUTES

53       See attributes(5) for description of the following attributes:
54
55
56
57
58       ┌─────────────────────────────┬─────────────────────────────┐
59       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
60       ├─────────────────────────────┼─────────────────────────────┤
61       │MT-Level                     │Safe                         │
62       └─────────────────────────────┴─────────────────────────────┘
63

SEE ALSO

65       libc_db(3LIB), thr_create(3C), thr_self(3C), attributes(5)
66
67
68
69SunOS 5.11                        20 Oct 1998          td_ta_map_id2thr(3C_DB)
Impressum