[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 1


pthdb_cond_addr, pthdb_cond_mutex or pthdb_cond_pshared Subroutine

Purpose

Gets the condition variable's mutex handle and pshared value.

Library

pthread debug library (libpthdebug.a)

Syntax

#include <sys/pthdebug.h>


int pthdb_cond_addr (pthdb_session_t session,
pthdb_cond_t cond,
pthdb_addr_t * addrp)


int pthdb_cond_mutex (pthdb_session_t session,
pthdb_cond_t cond,
pthdb_mutex_t * mutexp)


int pthdb_cond_pshared (pthdb_session_t session,
pthdb_cond_t cond,
pthdb_pshared_t * psharedp)

Description

The pthdb_cond_addr function reports the address of the pthdb_cond_t.

The pthdb_cond_mutex function is used to get the mutex handle associated with the particular condition variable, if the mutex does not exist then PTHDB_INVALID_MUTEX is returned from the mutex.

The pthdb_cond_pshared function is used to get the condition variable process shared value. The pshared value can be PSH_SHARED, PSH_PRIVATE, or PSH_NOTSUP.

Parameters


addr Condition variable address
cond Condition variable handle
mutexp Pointer to mutex
psharedp Pointer to pshared value
session Session handle.

Return Values

If successful, these functions return PTHDB_SUCCESS. Otherwise, an error code is returned.

Error Codes


PTHDB_BAD_COND Invalid cond handle.
PTHDB_BAD_SESSION Invalid session handle.
PTHDB_CALLBACK Debugger call back error.
PTHDB_INVALID_MUTEX Invalid mutex.
PTHDB_INTERNAL Error in library.
PTHDB_POINTER Invalid pointer

Implementation Specifics

These subroutines are part of the Base Operating System (BOS) Runtime.

Related Information

The pthdebug.h file.

The pthread.h file.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]