pthread_resume_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

PTHREAD_JOIN(3) 					   BSD Library Functions Manual 					   PTHREAD_JOIN(3)

NAME

     pthread_join, pthread_timedjoin_np -- wait for thread termination

LIBRARY

     POSIX Threads Library (libpthread, -lpthread)

SYNOPSIS

     #include <pthread.h>

     int
     pthread_join(pthread_t thread, void **value_ptr);

     int
     pthread_timedjoin_np(pthread_t thread, void **value_ptr, const struct timespec *abstime);

DESCRIPTION

     The pthread_join() function suspends execution of the calling thread until the target thread terminates unless the target thread has already
     terminated.

     On return from a successful pthread_join() call with a non-NULL value_ptr argument, the value passed to pthread_exit() by the terminating
     thread is stored in the location referenced by value_ptr.	When a pthread_join() returns successfully, the target thread has been terminated.
     The results of multiple simultaneous calls to pthread_join() specifying the same target thread are undefined.  If the thread calling
     pthread_join() is cancelled, then the target thread is not detached.

     The pthread_timedjoin_np() function is equivalent to the pthread_join() function except it will return ETIMEDOUT if target thread does not
     exit before specified absolute time passes.

     A thread that has exited but remains unjoined counts against [_POSIX_THREAD_THREADS_MAX].

RETURN VALUES

     If successful, the pthread_join() and pthread_timedjoin_np() functions will return zero.  Otherwise an error number will be returned to indi-
     cate the error.

ERRORS

     The pthread_join() and pthread_timedjoin_np() functions will fail if:

     [EINVAL]		The implementation has detected that the value specified by thread does not refer to a joinable thread.

     [ESRCH]		No thread could be found corresponding to that specified by the given thread ID, thread.

     [EDEADLK]		A deadlock was detected or the value of thread specifies the calling thread.

     [EOPNOTSUPP]	The implementation detected that another caller is already waiting on thread.

     Additionally, the pthread_timedjoin_np() function will fail if:

     [ETIMEDOUT]	The specified absolute time passed while pthread_timedjoin_np() waited for thread exit.

SEE ALSO

     wait(2), pthread_create(3)

STANDARDS

     The pthread_join() function conforms to ISO/IEC 9945-1:1996 (``POSIX.1'').  The pthread_timedjoin_np() is a FreeBSD extension which first
     appeared in FreeBSD 6.1.

BSD
								 January 23, 2010							       BSD