NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO | RESTRICTIONS
#include <exec/chExec.h>int threadStop(KnCap * actorcap, int threadli);
CORE
This system call is strictly reserved for internal use only. It MUST NOT be used by any application.
The threadStop system call stops the thread threadli , in the actor whose capability is given by 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 given by 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 .
The threadStop and threadStart system calls are reserved for the usage of system or application debuggers, and should not be used inside applications.
Upon 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.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
The target actor and the current actor must be located on the same site.
NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO | RESTRICTIONS