pthdb_pthread_specific Subroutine

Base Operating System and Extensions Technical Reference, Volume 1

Purpose

Reports the value associated with a pthread's 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

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

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.

Implementation Specifics

This subroutine is part of the Base Operating System (BOS) Runtime.

Related information

The pthdebug.h file.