NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO
#include <afexec.h>int akill(const KnCap *cactorcap);
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.
The akill() call stops and deletes the actor identified by cactorcap (see afexec(2K)), unless the actor is a restartable actor. If the actor is a restartable actor, calling akill() simply restarts the actor, as if it had terminated abnormally. To kill a restartable actor permanently, rather than simply restart it, call hrKillGroup(2RESTART).
The akill() call returns 0 if the actor was killed successfully, even if it restarts. Otherwise, akill() returns -1 and sets errno to indicate one of the following error conditions:
cactorcap points to an illegal address.
cactorcap either points to an illegal capability, or the actor with the capability given does not exist.
the calling actor is not a trusted actor or a supervisor actor, and the user ID of the calling actor does not match the user ID of the killed actor.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Deprecated : Replaced by kill(2POSIX) |
NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO