Killing Restartable Processes

At times it may be necessary to circumvent the automatic restart mechanism provided by the Hot Restart Controller and explicitly terminate (kill) a restartable process. Processes which are killed will not be restarted. Killing a process automatically kills all processes within the process's restart group. This is because a restart group must remain consistent. The restart group may not be able to function correctly if a process is no longer available.

Restartable processes 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 process'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 pid);

Either method produces the same result: all processes in the associated restart group are killed. The Hot Restart Controller terminates the group as though all processes had exited cleanly (see "Group Termination" Group Termination).