pthdb_pthread_specific Subroutine

Purpose

Reports the value associated with a pthreads specific data key.

Library

pthread debug library (libpthdebug.a)

Syntax

#include <sys/pthdebug.h>

void *pthdb_pthread_specific(pthdb_session_t  session,
                             pthdb_pthread_t  pthread,
                             pthdb_key_t    key,
                             pthdb_addr_t    * specificp)

Description

Each process has active pthread specific data keys. Each active pthread specific data key is in use by one or more pthreads. Each pthread can have its own value associated with each pthread specific data key. The pthdb_pthread_specific function provide access to those values.

pthdb_pthread_specific reports the specific data value for the pthread and key combination.

Parameters

Item Description
session The session handle.
pthread The pthread handle.
key The key.
specificp Specific data value buffer.a

Return Values

If successful, pthdb_pthread_specific returns PTHDB_SUCCESS. Otherwise, an error code is returned.

Error Codes

Item Description
PTHDB_BAD_SESSION Invalid session handle.
PTHDB_BAD_PTHREAD Invalid pthread handle.
PTHDB_BAD_KEY Invalid key.
PTHDB_BAD_POINTER Invalid buffer pointer.
PTHDB_CALLBACK Debugger call back error.
PTHDB_INTERNAL Error in library.