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 13.1-RELEASE-p6        October 12, 2021        FreeBSD 13.1-RELEASE-p6