NAME
pthread_suspend_np
—
suspend a thread
LIBRARY
POSIX Threads Library (libpthread, -lpthread)
SYNOPSIS
#include
<pthread_np.h>
int
pthread_suspend_np
(pthread_t
tid);
DESCRIPTION
The
pthread_suspend_np
()
function, called on an active thread, causes it to suspend.
It is not safe for the caller of the
pthread_suspend_np
()
function to use any non-async signal safe functions, except
pthread_resume_np(3), until suspended thread is resumed,
unless measures are taken to ensure that the thread is suspended at a safe
point.
RETURN VALUES
If successful, pthread_suspend_np
()
function returns 0. Otherwise, an error number is returned to indicate the
error.
ERRORS
The pthread_suspend_np
() function will
fail if:
- [
EDEADLK
] - An attempt was made to suspend the current thread.
- [
EINVAL
] - The value specified by the tid argument is invalid.
- [
ESRCH
] - No thread could be found corresponding to the thread ID specified by the tid argument.
SEE ALSO
pthread_np(3), pthread_resume_all_np(3), pthread_resume_np(3), pthread_suspend_all_np(3)
AUTHORS
This manual page was written by Alexey Zelkin <phantom@FreeBSD.org>.