Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pthread_suspend_np(3) [netbsd man page]

PTHREAD_SUSPEND_NP(3)					   BSD Library Functions Manual 				     PTHREAD_SUSPEND_NP(3)

NAME
pthread_suspend_np, pthread_resume_np -- suspend/resume the given thread LIBRARY
POSIX Threads Library (libpthread, -lpthread) SYNOPSIS
#include <pthread.h> int pthread_suspend_np(pthread_t thread); int pthread_resume_np(pthread_t thread); DESCRIPTION
The pthread_suspend_np() function suspends the thread given as argument. If thread is the currently running thread as returned by pthread_self(3), the function fails and returns EDEADLK. Otherwise, it removes the named thread from the running queue, and adds it to the suspended queue. The thread will remain blocked until pthread_resume_np() is called on it. In other words, pthread_resume_np() resumes the thread given as argument, if it was suspended. RETURN VALUES
Both functions return 0 on success and an error number indicating the reason for the failure. COMPATIBILITY
These functions are non-standard extensions. ERRORS
The pthread_suspend_np() function may fail if: [EDEADLK] The thread requested to suspend was the currently running thread. [ESRCH] The supplied thread was invalid. The pthread_resume_np() function may fail if: [ESRCH] The supplied thread was invalid. NOTES
Some pthread_suspend_np() implementations may allow suspending the current thread. This is dangerous, because the semantics of the function would then require the scheduler to schedule another thread, causing a thread context switch. Since that context switch can happen in a sig- nal handler by someone calling pthread_suspend_np() in a signal handler, this is currently not allowed. In pthread_resume_np() the NetBSD implementation does not check if the thread argument is not already suspended. Some implementations might return an error condition if pthread_resume_np() is called on a non-suspended thread. SEE ALSO
pthread_attr_setcreatesuspend_np(3), pthread_self(3) BSD
July 9, 2010 BSD

Check Out this Related Man Page

PTHREAD_JOIN(3) 					     Library Functions Manual						   PTHREAD_JOIN(3)

NAME
pthread_join - wait for termination of another thread SYNOPSIS
#include <pthread.h> int pthread_join(pthread_t th, void **thread_return); DESCRIPTION
pthread_join suspends the execution of the calling thread until the thread identified by th terminates, either by calling pthread_exit(3) or by being cancelled. If thread_return is not NULL, the return value of th is stored in the location pointed to by thread_return. The return value of th is either the argument it gave to pthread_exit(3), or PTHREAD_CANCELED if th was cancelled. The joined thread th must be in the joinable state: it must not have been detached using pthread_detach(3) or the PTHREAD_CREATE_DETACHED attribute to pthread_create(3). When a joinable thread terminates, its memory resources (thread descriptor and stack) are not deallocated until another thread performs pthread_join on it. Therefore, pthread_join must be called once for each joinable thread created to avoid memory leaks. At most one thread can wait for the termination of a given thread. Calling pthread_join on a thread th on which another thread is already waiting for termination returns an error. CANCELLATION
pthread_join is a cancellation point. If a thread is canceled while suspended in pthread_join, the thread execution resumes immediately and the cancellation is executed without waiting for the th thread to terminate. If cancellation occurs during pthread_join, the th thread remains not joined. RETURN VALUE
On success, the return value of th is stored in the location pointed to by thread_return, and 0 is returned. On error, a non-zero error code is returned. ERRORS
ESRCH No thread could be found corresponding to that specified by th. EINVAL The th thread has been detached. EINVAL Another thread is already waiting on termination of th. EDEADLK The th argument refers to the calling thread. AUTHOR
Xavier Leroy <Xavier.Leroy@inria.fr> SEE ALSO
pthread_exit(3), pthread_detach(3), pthread_create(3), pthread_attr_setdetachstate(3), pthread_cleanup_push(3), pthread_key_create(3). LinuxThreads PTHREAD_JOIN(3)
Man Page