Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

System Functions (n - p) pthread_get_threadstateinfo_np(2)
NAME
pthread_get_threadstateinfo_np - Gets the thread state information
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
32-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/zputdll
64-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/yputdll
H-series and J-series OSS processes that use the Standard POSIX Threads library:
/G/system/zdllnnn/zsptdll
SYNOPSIS
#include <pthread.h> | #include <spthread.h>
/* pthread.h is required to use POSIX User Thread Model library */
/* spthread.h is required to use Standard POSIX Threads library */
int pthread_get_threadstateinfo_np(
pthread_t *tid,
char *state);
PARAMETERS
tid Specifies the thread ID for which the state information is to be fetched.
state Specifies a pointer to the buffer where the thread state information is to be
stored. The buffer must be at least 15 bytes in length.
DESCRIPTION
The pthread_get_threadstateinfo_np( ) obtains the state information of the thread identified by
the tid parameter. On successful completion, the buffer contains a string that indicates the
current state of the thread. Possible string values are:
RUNNING The thread is running.
READY The thread is ready to run.
BLOCKED The thread is blocked.
TERMINATED
The thread is terminated.
On systems running H06.21 or later H-series RVUs or J06.10 or later J-series RVUs, you can use
either the POSIX User Thread Model library or the Standard POSIX Threads library for threaded
applications.
To use this function in a threaded application that uses the POSIX User Thread Model library on
systems running H06.21 or later RVUs or J06.10 or later RVUs, you must perform all of the fol-
lowing tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library (/G/system/zdllnnn/zputdll).
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
the POSIX User Thread Model library with 32-bit or 64-bit threaded applications.
527186-023 Hewlett-Packard Company 5−123