PTHREAD_*_NP(3) BSD Programmer's Manual PTHREAD_*_NP(3)NAME
pthread_attr_setsuspendstate_np, pthread_attr_getsuspendstate_np,
pthread_getstackbase_np, pthread_getstackpointer_np,
pthread_getstacksize_np, pthread_resume_np, pthread_resume_all_np,
pthread_suspend_np, pthread_suspend_all_np - pthread non-POSIX functions
SYNOPSIS
#include <pthread.h>
int
pthread_attr_setsuspendstate_np(pthread_attr_t *attr, int suspendstate);
int
pthread_attr_getsuspendstate_np(pthread_attr_t *attr, int *suspendstate);
int
pthread_getstackbase_np(pthread_t *thread, int *stackbase);
int
pthread_getstackpointer_np(pthread_t *thread, int *stackpointer);
int
pthread_getstacksize_np(pthread_t *thread, int *stacksize);
int
pthread_resume_np(pthread_t *thread);
int
pthread_resume_all_np();
int
pthread_suspend_np(pthread_t *thread);
int
pthread_suspend_all_np();
DESCRIPTION
These functions are NOT defined by IEEE Std1003.1c (``POSIX'').
The pthread_attr_getsuspendstate_np() and
pthread_attr_setsuspendstate_np() functions get and set the PTHREAD_CRE-
ATE_SUSPENDED thread creation attribute in attr.
The pthread_getstackbase_np() function gets the value of stackbase for
the thread specified by thread.
The pthread_getstackpointer_np() function gets the value of the stack
pointer for the thread specified by thread.
The pthread_getstacksize_np() function get the stack size for the thread
specified by thread.
The pthread_suspend_np() and pthread_resume_np() functions suspend and
resume the execution of the thread specified by thread.
The pthread_suspend_all_np() and pthread_resume_all_np() functions sus-
pend and resume the execution of all threads except the current thread.
RETURN VALUES
Upon successful completion the pthread_attr_setsuspendstate_np,
pthread_attr_getsuspendstate_np, pthread_getstackbase_np,
pthread_getstackpointer_np, pthread_getstacksize_np, pthread_resume_np,
pthread_resume_all_np, pthread_suspend_np and pthread_suspend_all_np
functions all return 0. A non-zero result indicates that an error oc-
curred.
ERRORS
The pthread_attr_setsuspendstate_np, pthread_attr_getsuspendstate_np,
pthread_getstackbase_np, pthread_getstackpointer_np,
pthread_getstacksize_np, pthread_resume_np, pthread_resume_all_np,
pthread_suspend_np and pthread_suspend_all_np functions may fail and re-
turn the following error:
[EINVAL] The value of a function argument is invalid.
HISTORY
The pthread_attr_setsuspendstate_np, pthread_attr_getsuspendstate_np,
pthread_getstackbase_np, pthread_getstackpointer_np,
pthread_getstacksize_np, pthread_resume_np, pthread_resume_all_np,
pthread_suspend_np and pthread_suspend_all_np functions first appeared in
BSD/OS 4.0.
4th Berkeley Distribution May 29, 1998 2
