rfc15: describe method for killing container

Problem: the method for delivering SIGKILL to all members of the job's container is not described. Describe the mechanism.
flux-framework · Oct 17, 2024 · 53757f4 · 53757f4
1 parent ba16b1d
commit 53757f4
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 2 deletions.
diff --git a/spec_15.rst b/spec_15.rst
@@ -389,8 +389,10 @@ to do so, the IMP SHALL handle SIGUSR1 as a surrogate for SIGKILL.  Upon
 receipt of this signal, the IMP SHOULD deliver SIGKILL to all processes in
 the job's container, including the job shell.
 
-The mechanism by which processes are identified to receive SIGKILL is
-outside the scope of this document.
+The IMP shall get the basename of the current cgroup directory at startup.
+If the directory begins with "imp-shell", then the IMP SHALL deliver SIGKILL
+to all PIDs listed in cgroup.procs. Otherwise, the IMP SHALL deliver SIGKILL
+only to its direct child and optionally MAY include descendants.
 
 IMP configuration
 =================

diff --git a/spell.en.pws b/spell.en.pws
@@ -492,3 +492,5 @@ DoS
 lookups
 chu
 unsatisfiable
+cgroup
+procs