NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO
#include <exec/chExec.h>int threadStop(KnCap * actorcap, int threadli);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
CORE
The threadStop() system call stops the thread, threadli , in the actor whose capability is actorcap .
The thread must either be owned by the actor or have entered the actor through a safe LAP invocation (see svLapCreate(2K) ).
The effect of threadStop() is to prevent the thread from running until the thread is restarted using threadStart() (see svLapCreate(2K) ) and becomes runnable (not suspended, and scheduled).
The effect of threadStop() is not instantaneous on threads executing system calls implemented via trap or cross-actor invocation, but it is guaranteed that a thread performing such a system call will not return from that call.
The threadStart() system call restarts the thread threadli , in the actor whose capability is actorcap .
The thread must either be owned by the actor or have entered the actor through a safe LAP invocation (see svLapCreate(2K) ).
It may only be applied to a thread previously stopped by threadStop() , or by actorStop(2K_I) .
The threadStop() and threadStart() system calls are reserved for the use of system or application debuggers and should not be used inside applications.
On successful completion, a value of 0 is returned. Otherwise, a negative error code is returned.
actorcap is an inconsistent actor capability, or threadli is not a valid thread identifier in the specified actor.
actorcap does not specify a reachable actor.
Some of the data provided are outside the current actor's address space.
The target actor and the current actor must be located on the same site.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO