thr_suspend(3thread)


thr_suspend -- suspend the execution of a thread

Synopsis

   cc [options] -Kthread file
   

#include <thread.h>

int thr_suspend(thread_t target_thread);

Description

thr_suspend suspends execution of target_thread. thr_suspend returns when target_thread is suspended. A concurrent thr_continue of the same thread might be lost or might take effect depending on the timing.

If target_thread is already suspended, thr_suspend has no effect.

A thread might suspend itself.

thr_continue will resume the execution of target_thread.

Parameters


target_thread
thread ID of the thread to be suspended

Return values

thr_suspend returns zero for success and an error number for failure.

Errors

If any of the following conditions occurs, thr_suspend returns the corresponding value:

ESRCH
target_thread cannot be found in the current process

Usage

We do not recommend using thr_suspend and thr_continue to synchronize threads. Use synchronization routines instead.

References

Intro(3thread), _lwp_continue(2), _lwp_suspend(2), thr_continue(3thread), thr_create(3thread)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004