4.3 Killing Restartable Actors

At times it may be desirable to circumvent the automatic restart mechanism provided by the Hot Restart Controller and explicitly terminate (kill) a restartable actor. Actors which are killed will not be restarted. Killing an actor automatically kills all actors within the actor's restart group. This is because a restart group must remain consistent, and may not be able to function properly if an actor is no longer present.

Restartable actors can be explicitly killed using either of the following:

• the C_INIT command akill(1M) with the -g option,

• the API call hrKillGroup(2RESTART) with the actor's group ID:

  #include <hr/hr.h>
  int hrKillGroup (int groupId);

  The group ID can be queried using the hrGetActorGroup(2RESTART) call:

  #include <hr/hr.h>
  int hrGetActorGroup(int aid);

Either method has the same result: all actors in the associated restart group are killed, and the Hot Restart Controller terminates the group as though all actors had exited cleanly (see "4.2.4.1 Group Termination").