Manual Pages for UNIX Operating System command usage for man td_ta_map_id2thr

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 
     #include 

     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  han-
     dle 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 associ-
                 ated 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




SunOS 5.11          Last change: 20 Oct 1998                    1






Threads Debugging Library Functions       td_ta_map_id2thr(3C_DB)



     See attributes(5) for description of  the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|


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









































SunOS 5.11          Last change: 20 Oct 1998                    2