xref: /illumos-gate/usr/src/man/man3c_db/td_ta_map_id2thr.3c_db (revision a61ed2ce7a86a4d6428f2a83eb4739fae945447e)
te
Copyright (c) 1998 Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
TD_TA_MAP_ID2THR 3C_DB "Oct 20, 1998"
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)