NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO
#include <am/afexec.h>int akill(const KnCap *cactorcap);
ACTOR_EXTENDED_MNGT
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 permanently kill (and not simply restart) a restartable actor, 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 points to an illegal capability or the actor with the capability given doesn't 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 | Evolving |
NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO