xref: /illumos-gate/usr/src/man/man3c_db/td_ta_map_addr2sync.3c_db (revision 8c0b080c8ed055a259d8cd26b9f005211c6a9753)
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_ADDR2SYNC 3C_DB "Oct 20, 1998"
NAME
td_ta_map_addr2sync - get a synchronization object handle from a synchronization object's address
SYNOPSIS

cc [ flag... ] file... -lc_db [ library... ]
#include <proc_service.h>
#include <thread_db.h>

td_ta_map_addr2sync(const td_thragent_t *ta_p, psaddr_t addr, td_synchandle_t *sh_p);
DESCRIPTION

The td_ta_map_addr2sync() function produces the synchronization object handle of type td_synchandle_t that corresponds to the address of the synchronization object (mutex, semaphore, condition variable, or reader/writer lock). Some effort is made to validate addr and verify that it does indeed point at a synchronization object. The handle is returned in *sh_p.

RETURN VALUES
TD_OK

The call completed successfully.

TD_BADTA

An invalid internal process handle was passed.

TD_BADPH

There is a NULL external process handle associated with this internal process handle.

TD_BADSH

The sh_p argument is NULL or addr does not appear to point to a valid synchronization object.

TD_DBERR

A call to one of the imported interface routines failed.

TD_ERR

addr is NULL, or a libc_db internal error occurred.

ATTRIBUTES

See attributes(7) for description of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
MT-Level Safe
SEE ALSO

libc_db (3LIB), attributes (7)