HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/nan.3m
________________________________________________________________
___ ___
p
pthread_resume_np(3T) pthread_resume_np(3T)
(Pthread Library)
NAME
pthread_continue(), pthread_resume_np(), pthread_suspend() - continue execution of a thread, resume exe-
cution of a thread, and suspend execution of a thread; respectively
SYNOPSIS
#include <pthread.h>
int pthread_continue(
pthread_t thread
);
int pthread_resume_np(
pthread_t thread,
int flags
);
int pthread_suspend(
pthread_t thread
);
PARAMETERS
thread whose execution is to be suspended or resumed.
flags Flags to be used by pthread_resume_np().
The valid values are:
PTHREAD_COUNT_RESUME_NP
The target thread’s suspension count is decremented by one. If the target thread was
suspended and has a suspend count greater than one, the thread will not resume exe-
cution.
PTHREAD_FORCE_RESUME_NP
The target thread’s suspension count is set to zero. The target will resume execution
even if its suspend count was greater than one.
DESCRIPTION
The pthread_suspend()
function suspends execution of the target thread specified by thread. The tar-
get thread may not be suspended immediately (at that exact instant). On successful return from the
pthread_suspend() function, thread is no longer executing. Once a thread has been suspended, subse-
quent calls to the
pthread_suspend()
function increment a per thread suspension count and return
immediately.
Calling
pthread_suspend()
with the calling thread specified in thread is allowed. Note that in this
case the calling thread shall be suspended during execution of the
pthread_suspend()
function call
and shall only return after another thread has called the
pthread_resume_np()
or
pthread_continue() function for thread.
The pthread_continue() function resumes the execution of the target thread thread.Ifthread was
suspended by multiple calls to pthread_suspend(), only one call to pthread_continue() is
required to resume the execution of thread. Calling pthread_continue() for a target thread that is
not suspended shall have no effect and return no errors. Calling pthread_continue()
is equivalent to
calling
pthread_resume_np()
with the flags parameter specified as
PTHREAD_FORCE_RESUME_NP
.
The
pthread_resume_np()
function resumes the execution of the target thread specified by thread. If
the flags argument is
PTHREAD_COUNT_RESUME_NP
, the target thread’s suspension count is decre-
mented by one. If the flags argument is
PTHREAD_FORCE_RESUME_NP, the target thread’s suspension
count is set to zero. When the target thread’s suspension count reaches zero, the target thread is allowed to
continue execution. Calling
pthread_resume_np() for a target thread that is not suspended shall
have no effect and return no errors.
RETURN VALUE
If successful, pthread_continue(), pthread_suspend()
and pthread_resume_np() return
zero. Otherwise, an error number shall be returned to indicate the error (the
errno variable is not set).
ERRORS
If any of the following occur, the pthread_suspend()
function returns the corresponding error
number.
Section 3−−710 − 1 − HP-UX Release 11i: December 2000
___
___