xref: /illumos-gate/usr/src/man/man3c_db/td_thr_lockowner.3c_db (revision 5d9d9091f564c198a760790b0bfa72c44e17912b)
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_THR_LOCKOWNER 3C_DB "Oct 20, 1998"
NAME
td_thr_lockowner - iterate over the set of locks owned by a thread
SYNOPSIS

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

td_err_e td_thr_lockowner(const td_thrhandle_t *th_p, td_sync_iter_f *cb,
 void *cb_data_p);
DESCRIPTION

The td_thr_lockowner() function calls the iterator function cb once for every mutex that is held by the thread whose handle is th_p. The synchronization handle and the pointer cb_data_p are passed to the function. See td_ta_thr_iter(3C_DB) for a similarly structured function.

Iteration terminates early if the callback function cb returns a non-zero value.

RETURN VALUES
TD_OK

The call completed successfully.

TD_BADTH

An invalid thread 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_ERR

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), td_ta_thr_iter(3C_DB), attributes(7)