FreeBSD manual
download PDF document: pthread_suspend_np.3.pdf
PTHREAD_SUSPEND_NP(3) FreeBSD Library Functions Manual PTHREAD_SUSPEND_NP(3)
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>.
FreeBSD 14.2-RELEASE October 12, 2021 FreeBSD 14.2-RELEASE