]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
core: followups for the recent subgroup killing commits
authorLennart Poettering <lennart@poettering.net>
Wed, 9 Jul 2025 14:27:28 +0000 (16:27 +0200)
committerYu Watanabe <watanabe.yu+github@gmail.com>
Thu, 10 Jul 2025 04:32:51 +0000 (13:32 +0900)
This is a follow-up for 0f23564ad4a191a92bc5544edf800bb2cfbb3513 and
6b02854f508be3f27b45353dd1d12de7d93cab5f, as suggested here:

https://github.com/systemd/systemd/pull/37855#pullrequestreview-2997596953

man/org.freedesktop.systemd1.xml
src/core/dbus-manager.c
src/core/unit.c
src/systemctl/systemctl.c
test/units/TEST-07-PID1.subgroup-kill.sh

index a49b81b0c624442ad259da5b71627712663aa680..ea3a14f7183eea08eb91a8b12020bdd60ee70b5e 100644 (file)
@@ -1339,11 +1339,11 @@ node /org/freedesktop/systemd1 {
       matching process was found (otherwise it will return successfully, executing no operation).</para>
 
       <para><function>KillUnitSubgroup()</function> is just like <function>KillUnit()</function> but takes an
-      additional path argument that selects a sub-control-group of the unit's control group. Only processes
+      additional path argument that selects a sub-control group of the unit's control group. Only processes
       in that subgroup are killed. The path my be specified with our without leading <literal>/</literal>, in
       both cases it is taken relatively to the unit's control group. If the subgroup path is specified as an
       empty string or as <literal>/</literal> it has the same effect as <function>KillUnit()</function>. If
-      it is specified as anything else the <literal>who</literal> parameter must be set to either
+      it is specified as anything else the <literal>whom</literal> parameter must be set to either
       <literal>cgroup</literal> or <literal>cgroup-fail</literal>.</para>
 
       <para><function>QueueSignalUnit()</function> is similar to <function>KillUnit()</function> but may be
index 6b6b8916de459881e94b73a72529ab8be379725d..50805fd531b03c8a2319034c2b6deb3f644439f2 100644 (file)
@@ -826,14 +826,14 @@ static int method_start_unit_replace(sd_bus_message *message, void *userdata, sd
 }
 
 static int method_kill_unit(sd_bus_message *message, void *userdata, sd_bus_error *error) {
-        /* We don't bother with GENERIC_UNIT_LOAD nor GENERIC_UNIT_VALIDATE_LOADED here, as it shouldn't
-         * matter whether a unit is loaded for killing any processes possibly in the unit's cgroup. */
+        /* We don't bother with GENERIC_UNIT_LOAD or GENERIC_UNIT_VALIDATE_LOADED here, as it shouldn't
+         * matter whether a unit is loaded for killing any processes in the unit's cgroup. */
         return method_generic_unit_operation(message, userdata, error, bus_unit_method_kill, 0);
 }
 
 static int method_kill_unit_subgroup(sd_bus_message *message, void *userdata, sd_bus_error *error) {
-        /* We don't bother with GENERIC_UNIT_LOAD nor GENERIC_UNIT_VALIDATE_LOADED here, as it shouldn't
-         * matter whether a unit is loaded for killing any processes possibly in the unit's cgroup. */
+        /* We don't bother with GENERIC_UNIT_LOAD or GENERIC_UNIT_VALIDATE_LOADED here, as it shouldn't
+         * matter whether a unit is loaded for killing any processes in the unit's cgroup. */
         return method_generic_unit_operation(message, userdata, error, bus_unit_method_kill_subgroup, 0);
 }
 
index 9051fc69236e199202fde461fc9e9f7b9ed3af7a..26d196cfcaa9838c9fcf670f14b1cf6356186c51 100644 (file)
@@ -4065,10 +4065,12 @@ int unit_kill(
 
         if (subgroup) {
                 if (!IN_SET(whom, KILL_CGROUP, KILL_CGROUP_FAIL))
-                        return sd_bus_error_set(ret_error, SD_BUS_ERROR_NOT_SUPPORTED, "Killing by subgroup is only supported for 'cgroup' or 'cgroup-kill' modes.");
+                        return sd_bus_error_set(ret_error, SD_BUS_ERROR_NOT_SUPPORTED,
+                                                "Killing by subgroup is only supported for 'cgroup' or 'cgroup-kill' modes.");
 
                 if (!unit_cgroup_delegate(u))
-                        return sd_bus_error_set(ret_error, SD_BUS_ERROR_NOT_SUPPORTED, "Killing by subgroup is only available for units with control group delegation enabled.");
+                        return sd_bus_error_set(ret_error, SD_BUS_ERROR_NOT_SUPPORTED,
+                                                "Killing by subgroup is only available for units with control group delegation enabled.");
         }
 
         main_pid = unit_main_pid(u);
index cfe206a94ba197a422d675507ff58ff492b08e63..47a8867630521bf3a9abaab01b14938853f97b5c 100644 (file)
@@ -260,7 +260,7 @@ static int systemctl_help(void) {
                "     --kill-whom=WHOM    Whom to send signal to\n"
                "     --kill-value=INT    Signal value to enqueue\n"
                "     --kill-subgroup=PATH\n"
-               "                         Send signal to sub-control-group only\n"
+               "                         Send signal to sub-control group only\n"
                "     --what=RESOURCES    Which types of resources to remove\n"
                "     --now               Start or stop unit after enabling or disabling it\n"
                "     --dry-run           Only print what would be done\n"
index f62340e7ea49b04f5cf2d1f77a8b29bd99bf02a9..c8eb6539abbd8fb0948f5b63392ded8757001b84 100755 (executable)
@@ -36,4 +36,4 @@ systemctl kill user@"$(id -u testuser)".service --kill-subgroup=app.slice/subgro
 run0 -u testuser systemctl --user is-active subgroup-test.service
 systemctl kill user@"$(id -u testuser)".service --kill-subgroup=app.slice/subgroup-test.service --kill-whom=cgroup-fail
 
-timeout 60 bash -c 'while run0 -u testuser systemctl --user is-active subgroup-test.service ; do sleep 1 ; done'
+timeout 60 bash -c 'while run0 -u testuser systemctl --user is-active subgroup-test.service; do sleep 1; done'