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.

AUTHORS

This manual page was written by Alexey Zelkin <phantom@FreeBSD.org>.