52b84b
From 046ea98539eb8d7cef93d8062035fa6d9f58efea Mon Sep 17 00:00:00 2001
52b84b
From: =?UTF-8?q?Michal=20Sekleta=CC=81r?= <msekleta@redhat.com>
52b84b
Date: Wed, 29 Apr 2020 17:53:43 +0200
52b84b
Subject: [PATCH] core: introduce support for cgroup freezer
52b84b
52b84b
With cgroup v2 the cgroup freezer is implemented as a cgroup
52b84b
attribute called cgroup.freeze. cgroup can be frozen by writing "1"
52b84b
to the file and kernel will send us a notification through
52b84b
"cgroup.events" after the operation is finished and processes in the
52b84b
cgroup entered quiescent state, i.e. they are not scheduled to
52b84b
run. Writing "0" to the attribute file does the inverse and process
52b84b
execution is resumed.
52b84b
52b84b
This commit exposes above low-level functionality through systemd's DBus
52b84b
API. Each unit type must provide specialized implementation for these
52b84b
methods, otherwise, we return an error. So far only service, scope, and
52b84b
slice unit types provide the support. It is possible to check if a
52b84b
given unit has the support using CanFreeze() DBus property.
52b84b
52b84b
Note that DBus API has a synchronous behavior and we dispatch the reply
52b84b
to freeze/thaw requests only after the kernel has notified us that
52b84b
requested operation was completed.
52b84b
52b84b
(cherry picked from commit d9e45bc3abb8adf5a1cb20816ba8f2d2aa65b17e)
52b84b
52b84b
Resolves: #1830861
52b84b
---
52b84b
 man/systemctl.xml                         |  24 +++++
52b84b
 src/basic/cgroup-util.c                   |  18 +++-
52b84b
 src/basic/cgroup-util.h                   |   1 +
52b84b
 src/basic/unit-def.c                      |   9 ++
52b84b
 src/basic/unit-def.h                      |  12 +++
52b84b
 src/core/cgroup.c                         | 105 ++++++++++++++++--
52b84b
 src/core/cgroup.h                         |  12 +++
52b84b
 src/core/dbus-manager.c                   |  50 +++++++++
52b84b
 src/core/dbus-unit.c                      |  96 +++++++++++++++++
52b84b
 src/core/dbus-unit.h                      |   3 +
52b84b
 src/core/dbus.c                           |   7 +-
52b84b
 src/core/scope.c                          |   3 +
52b84b
 src/core/service.c                        |   3 +
52b84b
 src/core/slice.c                          |  80 ++++++++++++++
52b84b
 src/core/unit.c                           | 123 ++++++++++++++++++++++
52b84b
 src/core/unit.h                           |  20 ++++
52b84b
 src/libsystemd/sd-bus/bus-common-errors.h |   2 +
52b84b
 src/systemctl/systemctl.c                 | 105 +++++++++++++++++-
52b84b
 18 files changed, 660 insertions(+), 13 deletions(-)
52b84b
52b84b
diff --git a/man/systemctl.xml b/man/systemctl.xml
52b84b
index d95d3726af..6145486123 100644
52b84b
--- a/man/systemctl.xml
52b84b
+++ b/man/systemctl.xml
52b84b
@@ -873,6 +873,30 @@ Sun 2017-02-26 20:57:49 EST  2h 3min left  Sun 2017-02-26 11:56:36 EST  6h ago
52b84b
             the signal to send.</para>
52b84b
           </listitem>
52b84b
         </varlistentry>
52b84b
+        <varlistentry>
52b84b
+          <term><command>freeze <replaceable>PATTERN</replaceable>…</command></term>
52b84b
+
52b84b
+          <listitem>
52b84b
+            <para>Freeze one or more units specified on the
52b84b
+            command line using cgroup freezer</para>
52b84b
+
52b84b
+            <para>Freezing the unit will cause all processes contained within the cgroup corresponding to the unit
52b84b
+            to be suspended. Being suspended means that unit's processes won't be scheduled to run on CPU until thawed.
52b84b
+            Note that this command is supported only on systems that use unified cgroup hierarchy. Unit is automatically
52b84b
+            thawed just before we execute a job against the unit, e.g. before the unit is stopped.</para>
52b84b
+          </listitem>
52b84b
+        </varlistentry>
52b84b
+        <varlistentry>
52b84b
+          <term><command>thaw <replaceable>PATTERN</replaceable>…</command></term>
52b84b
+
52b84b
+          <listitem>
52b84b
+            <para>Thaw (unfreeze) one or more units specified on the
52b84b
+            command line.</para>
52b84b
+
52b84b
+            <para>This is the inverse operation to the <command>freeze</command> command and resumes the execution of
52b84b
+            processes in the unit's cgroup.</para>
52b84b
+          </listitem>
52b84b
+        </varlistentry>
52b84b
         <varlistentry>
52b84b
           <term><command>is-active <replaceable>PATTERN</replaceable>…</command></term>
52b84b
 
52b84b
diff --git a/src/basic/cgroup-util.c b/src/basic/cgroup-util.c
52b84b
index 4c0b73850d..992b12811a 100644
52b84b
--- a/src/basic/cgroup-util.c
52b84b
+++ b/src/basic/cgroup-util.c
52b84b
@@ -137,6 +137,17 @@ bool cg_ns_supported(void) {
52b84b
         return enabled;
52b84b
 }
52b84b
 
52b84b
+bool cg_freezer_supported(void) {
52b84b
+        static thread_local int supported = -1;
52b84b
+
52b84b
+        if (supported >= 0)
52b84b
+                return supported;
52b84b
+
52b84b
+        supported = cg_all_unified() > 0 && access("/sys/fs/cgroup/init.scope/cgroup.freeze", F_OK) == 0;
52b84b
+
52b84b
+        return supported;
52b84b
+}
52b84b
+
52b84b
 int cg_enumerate_subgroups(const char *controller, const char *path, DIR **_d) {
52b84b
         _cleanup_free_ char *fs = NULL;
52b84b
         int r;
52b84b
@@ -2039,7 +2050,8 @@ int cg_get_keyed_attribute_full(
52b84b
          * all keys to retrieve. The 'ret_values' parameter should be passed as string size with the same number of
52b84b
          * entries as 'keys'. On success each entry will be set to the value of the matching key.
52b84b
          *
52b84b
-         * If the attribute file doesn't exist at all returns ENOENT, if any key is not found returns ENXIO. */
52b84b
+         * If the attribute file doesn't exist at all returns ENOENT, if any key is not found returns ENXIO. If mode
52b84b
+         * is set to GG_KEY_MODE_GRACEFUL we ignore missing keys and return those that were parsed successfully. */
52b84b
 
52b84b
         r = cg_get_path(controller, path, attribute, &filename);
52b84b
         if (r < 0)
52b84b
@@ -2089,8 +2101,8 @@ int cg_get_keyed_attribute_full(
52b84b
 
52b84b
         if (mode & CG_KEY_MODE_GRACEFUL)
52b84b
                 goto done;
52b84b
-        else
52b84b
-                r = -ENXIO;
52b84b
+
52b84b
+        r = -ENXIO;
52b84b
 
52b84b
 fail:
52b84b
         for (i = 0; i < n; i++)
52b84b
diff --git a/src/basic/cgroup-util.h b/src/basic/cgroup-util.h
52b84b
index 0673f4b4ce..1210b38a83 100644
52b84b
--- a/src/basic/cgroup-util.h
52b84b
+++ b/src/basic/cgroup-util.h
52b84b
@@ -250,6 +250,7 @@ int cg_mask_to_string(CGroupMask mask, char **ret);
52b84b
 int cg_kernel_controllers(Set **controllers);
52b84b
 
52b84b
 bool cg_ns_supported(void);
52b84b
+bool cg_freezer_supported(void);
52b84b
 
52b84b
 int cg_all_unified(void);
52b84b
 int cg_hybrid_unified(void);
52b84b
diff --git a/src/basic/unit-def.c b/src/basic/unit-def.c
52b84b
index 46593f6e65..e79cc73dd3 100644
52b84b
--- a/src/basic/unit-def.c
52b84b
+++ b/src/basic/unit-def.c
52b84b
@@ -107,6 +107,15 @@ static const char* const unit_active_state_table[_UNIT_ACTIVE_STATE_MAX] = {
52b84b
 
52b84b
 DEFINE_STRING_TABLE_LOOKUP(unit_active_state, UnitActiveState);
52b84b
 
52b84b
+static const char* const freezer_state_table[_FREEZER_STATE_MAX] = {
52b84b
+        [FREEZER_RUNNING] = "running",
52b84b
+        [FREEZER_FREEZING] = "freezing",
52b84b
+        [FREEZER_FROZEN] = "frozen",
52b84b
+        [FREEZER_THAWING] = "thawing",
52b84b
+};
52b84b
+
52b84b
+DEFINE_STRING_TABLE_LOOKUP(freezer_state, FreezerState);
52b84b
+
52b84b
 static const char* const automount_state_table[_AUTOMOUNT_STATE_MAX] = {
52b84b
         [AUTOMOUNT_DEAD] = "dead",
52b84b
         [AUTOMOUNT_WAITING] = "waiting",
52b84b
diff --git a/src/basic/unit-def.h b/src/basic/unit-def.h
52b84b
index db397a31ed..8eea379a6d 100644
52b84b
--- a/src/basic/unit-def.h
52b84b
+++ b/src/basic/unit-def.h
52b84b
@@ -44,6 +44,15 @@ typedef enum UnitActiveState {
52b84b
         _UNIT_ACTIVE_STATE_INVALID = -1
52b84b
 } UnitActiveState;
52b84b
 
52b84b
+typedef enum FreezerState {
52b84b
+        FREEZER_RUNNING,
52b84b
+        FREEZER_FREEZING,
52b84b
+        FREEZER_FROZEN,
52b84b
+        FREEZER_THAWING,
52b84b
+        _FREEZER_STATE_MAX,
52b84b
+        _FREEZER_STATE_INVALID = -1
52b84b
+} FreezerState;
52b84b
+
52b84b
 typedef enum AutomountState {
52b84b
         AUTOMOUNT_DEAD,
52b84b
         AUTOMOUNT_WAITING,
52b84b
@@ -245,6 +254,9 @@ UnitLoadState unit_load_state_from_string(const char *s) _pure_;
52b84b
 const char *unit_active_state_to_string(UnitActiveState i) _const_;
52b84b
 UnitActiveState unit_active_state_from_string(const char *s) _pure_;
52b84b
 
52b84b
+const char *freezer_state_to_string(FreezerState i) _const_;
52b84b
+FreezerState freezer_state_from_string(const char *s) _pure_;
52b84b
+
52b84b
 const char* automount_state_to_string(AutomountState i) _const_;
52b84b
 AutomountState automount_state_from_string(const char *s) _pure_;
52b84b
 
52b84b
diff --git a/src/core/cgroup.c b/src/core/cgroup.c
52b84b
index 7a9857adad..e7ae9273a6 100644
52b84b
--- a/src/core/cgroup.c
52b84b
+++ b/src/core/cgroup.c
52b84b
@@ -2279,6 +2279,51 @@ void unit_add_to_cgroup_empty_queue(Unit *u) {
52b84b
                 log_debug_errno(r, "Failed to enable cgroup empty event source: %m");
52b84b
 }
52b84b
 
52b84b
+static void unit_remove_from_cgroup_empty_queue(Unit *u) {
52b84b
+        assert(u);
52b84b
+
52b84b
+        if (!u->in_cgroup_empty_queue)
52b84b
+                return;
52b84b
+
52b84b
+        LIST_REMOVE(cgroup_empty_queue, u->manager->cgroup_empty_queue, u);
52b84b
+        u->in_cgroup_empty_queue = false;
52b84b
+}
52b84b
+
52b84b
+static int unit_check_cgroup_events(Unit *u) {
52b84b
+        char *values[2] = {};
52b84b
+        int r;
52b84b
+
52b84b
+        assert(u);
52b84b
+
52b84b
+        r = cg_get_keyed_attribute_graceful(SYSTEMD_CGROUP_CONTROLLER, u->cgroup_path, "cgroup.events",
52b84b
+                                            STRV_MAKE("populated", "frozen"), values);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        /* The cgroup.events notifications can be merged together so act as we saw the given state for the
52b84b
+         * first time. The functions we call to handle given state are idempotent, which makes them
52b84b
+         * effectively remember the previous state. */
52b84b
+        if (values[0]) {
52b84b
+                if (streq(values[0], "1"))
52b84b
+                        unit_remove_from_cgroup_empty_queue(u);
52b84b
+                else
52b84b
+                        unit_add_to_cgroup_empty_queue(u);
52b84b
+        }
52b84b
+
52b84b
+        /* Disregard freezer state changes due to operations not initiated by us */
52b84b
+        if (values[1] && IN_SET(u->freezer_state, FREEZER_FREEZING, FREEZER_THAWING)) {
52b84b
+                if (streq(values[1], "0"))
52b84b
+                        unit_thawed(u);
52b84b
+                else
52b84b
+                        unit_frozen(u);
52b84b
+        }
52b84b
+
52b84b
+        free(values[0]);
52b84b
+        free(values[1]);
52b84b
+
52b84b
+        return 0;
52b84b
+}
52b84b
+
52b84b
 static int on_cgroup_inotify_event(sd_event_source *s, int fd, uint32_t revents, void *userdata) {
52b84b
         Manager *m = userdata;
52b84b
 
52b84b
@@ -2310,15 +2355,12 @@ static int on_cgroup_inotify_event(sd_event_source *s, int fd, uint32_t revents,
52b84b
                                 /* The watch was just removed */
52b84b
                                 continue;
52b84b
 
52b84b
-                        u = hashmap_get(m->cgroup_inotify_wd_unit, INT_TO_PTR(e->wd));
52b84b
-                        if (!u) /* Not that inotify might deliver
52b84b
-                                 * events for a watch even after it
52b84b
-                                 * was removed, because it was queued
52b84b
-                                 * before the removal. Let's ignore
52b84b
-                                 * this here safely. */
52b84b
-                                continue;
52b84b
+                        /* Note that inotify might deliver events for a watch even after it was removed,
52b84b
+                         * because it was queued before the removal. Let's ignore this here safely. */
52b84b
 
52b84b
-                        unit_add_to_cgroup_empty_queue(u);
52b84b
+                        u = hashmap_get(m->cgroup_inotify_wd_unit, INT_TO_PTR(e->wd));
52b84b
+                        if (u)
52b84b
+                                unit_check_cgroup_events(u);
52b84b
                 }
52b84b
         }
52b84b
 }
52b84b
@@ -2884,6 +2926,46 @@ void manager_invalidate_startup_units(Manager *m) {
52b84b
                 unit_invalidate_cgroup(u, CGROUP_MASK_CPU|CGROUP_MASK_IO|CGROUP_MASK_BLKIO);
52b84b
 }
52b84b
 
52b84b
+int unit_cgroup_freezer_action(Unit *u, FreezerAction action) {
52b84b
+        _cleanup_free_ char *path = NULL;
52b84b
+        FreezerState target, kernel = _FREEZER_STATE_INVALID;
52b84b
+        int r;
52b84b
+
52b84b
+        assert(u);
52b84b
+        assert(IN_SET(action, FREEZER_FREEZE, FREEZER_THAW));
52b84b
+
52b84b
+        if (!u->cgroup_realized)
52b84b
+                return -EBUSY;
52b84b
+
52b84b
+        target = action == FREEZER_FREEZE ? FREEZER_FROZEN : FREEZER_RUNNING;
52b84b
+
52b84b
+        r = unit_freezer_state_kernel(u, &kernel);
52b84b
+        if (r < 0)
52b84b
+                log_unit_debug_errno(u, r, "Failed to obtain cgroup freezer state: %m");
52b84b
+
52b84b
+        if (target == kernel) {
52b84b
+                u->freezer_state = target;
52b84b
+                return 0;
52b84b
+        }
52b84b
+
52b84b
+        r = cg_get_path(SYSTEMD_CGROUP_CONTROLLER, u->cgroup_path, "cgroup.freeze", &path);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        log_unit_debug(u, "%s unit.", action == FREEZER_FREEZE ? "Freezing" : "Thawing");
52b84b
+
52b84b
+        if (action == FREEZER_FREEZE)
52b84b
+                u->freezer_state = FREEZER_FREEZING;
52b84b
+        else
52b84b
+                u->freezer_state = FREEZER_THAWING;
52b84b
+
52b84b
+        r = write_string_file(path, one_zero(action == FREEZER_FREEZE), WRITE_STRING_FILE_DISABLE_BUFFER);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        return 0;
52b84b
+}
52b84b
+
52b84b
 static const char* const cgroup_device_policy_table[_CGROUP_DEVICE_POLICY_MAX] = {
52b84b
         [CGROUP_AUTO] = "auto",
52b84b
         [CGROUP_CLOSED] = "closed",
52b84b
@@ -2919,3 +3001,10 @@ int unit_get_cpuset(Unit *u, CPUSet *cpus, const char *name) {
52b84b
 }
52b84b
 
52b84b
 DEFINE_STRING_TABLE_LOOKUP(cgroup_device_policy, CGroupDevicePolicy);
52b84b
+
52b84b
+static const char* const freezer_action_table[_FREEZER_ACTION_MAX] = {
52b84b
+        [FREEZER_FREEZE] = "freeze",
52b84b
+        [FREEZER_THAW] = "thaw",
52b84b
+};
52b84b
+
52b84b
+DEFINE_STRING_TABLE_LOOKUP(freezer_action, FreezerAction);
52b84b
diff --git a/src/core/cgroup.h b/src/core/cgroup.h
52b84b
index 976224336d..36ea77fdc5 100644
52b84b
--- a/src/core/cgroup.h
52b84b
+++ b/src/core/cgroup.h
52b84b
@@ -33,6 +33,14 @@ typedef enum CGroupDevicePolicy {
52b84b
         _CGROUP_DEVICE_POLICY_INVALID = -1
52b84b
 } CGroupDevicePolicy;
52b84b
 
52b84b
+typedef enum FreezerAction {
52b84b
+        FREEZER_FREEZE,
52b84b
+        FREEZER_THAW,
52b84b
+
52b84b
+        _FREEZER_ACTION_MAX,
52b84b
+        _FREEZER_ACTION_INVALID = -1,
52b84b
+} FreezerAction;
52b84b
+
52b84b
 struct CGroupDeviceAllow {
52b84b
         LIST_FIELDS(CGroupDeviceAllow, device_allow);
52b84b
         char *path;
52b84b
@@ -235,3 +243,7 @@ CGroupDevicePolicy cgroup_device_policy_from_string(const char *s) _pure_;
52b84b
 
52b84b
 bool unit_cgroup_delegate(Unit *u);
52b84b
 int unit_get_cpuset(Unit *u, CPUSet *cpus, const char *name);
52b84b
+int unit_cgroup_freezer_action(Unit *u, FreezerAction action);
52b84b
+
52b84b
+const char* freezer_action_to_string(FreezerAction a) _const_;
52b84b
+FreezerAction freezer_action_from_string(const char *s) _pure_;
52b84b
diff --git a/src/core/dbus-manager.c b/src/core/dbus-manager.c
52b84b
index b3c011b0df..a0777f63d5 100644
52b84b
--- a/src/core/dbus-manager.c
52b84b
+++ b/src/core/dbus-manager.c
52b84b
@@ -683,6 +683,54 @@ static int method_unref_unit(sd_bus_message *message, void *userdata, sd_bus_err
52b84b
         return bus_unit_method_unref(message, u, error);
52b84b
 }
52b84b
 
52b84b
+static int method_freeze_unit(sd_bus_message *message, void *userdata, sd_bus_error *error) {
52b84b
+        Manager *m = userdata;
52b84b
+        const char *name;
52b84b
+        Unit *u;
52b84b
+        int r;
52b84b
+
52b84b
+        assert(message);
52b84b
+        assert(m);
52b84b
+
52b84b
+        r = sd_bus_message_read(message, "s", &name);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        r = bus_load_unit_by_name(m, message, name, &u, error);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        r = bus_unit_validate_load_state(u, error);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        return bus_unit_method_freeze(message, u, error);
52b84b
+}
52b84b
+
52b84b
+static int method_thaw_unit(sd_bus_message *message, void *userdata, sd_bus_error *error) {
52b84b
+        Manager *m = userdata;
52b84b
+        const char *name;
52b84b
+        Unit *u;
52b84b
+        int r;
52b84b
+
52b84b
+        assert(message);
52b84b
+        assert(m);
52b84b
+
52b84b
+        r = sd_bus_message_read(message, "s", &name);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        r = bus_load_unit_by_name(m, message, name, &u, error);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        r = bus_unit_validate_load_state(u, error);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        return bus_unit_method_thaw(message, u, error);
52b84b
+}
52b84b
+
52b84b
 static int reply_unit_info(sd_bus_message *reply, Unit *u) {
52b84b
         _cleanup_free_ char *unit_path = NULL, *job_path = NULL;
52b84b
         Unit *following;
52b84b
@@ -2500,6 +2548,8 @@ const sd_bus_vtable bus_manager_vtable[] = {
52b84b
         SD_BUS_METHOD("ReloadOrRestartUnit", "ss", "o", method_reload_or_restart_unit, SD_BUS_VTABLE_UNPRIVILEGED),
52b84b
         SD_BUS_METHOD("ReloadOrTryRestartUnit", "ss", "o", method_reload_or_try_restart_unit, SD_BUS_VTABLE_UNPRIVILEGED),
52b84b
         SD_BUS_METHOD("KillUnit", "ssi", NULL, method_kill_unit, SD_BUS_VTABLE_UNPRIVILEGED),
52b84b
+        SD_BUS_METHOD("FreezeUnit", "s", NULL, method_freeze_unit, SD_BUS_VTABLE_UNPRIVILEGED),
52b84b
+        SD_BUS_METHOD("ThawUnit", "s", NULL, method_thaw_unit, SD_BUS_VTABLE_UNPRIVILEGED),
52b84b
         SD_BUS_METHOD("ResetFailedUnit", "s", NULL, method_reset_failed_unit, SD_BUS_VTABLE_UNPRIVILEGED),
52b84b
         SD_BUS_METHOD("SetUnitProperties", "sba(sv)", NULL, method_set_unit_properties, SD_BUS_VTABLE_UNPRIVILEGED),
52b84b
         SD_BUS_METHOD("RefUnit", "s", NULL, method_ref_unit, SD_BUS_VTABLE_UNPRIVILEGED),
52b84b
diff --git a/src/core/dbus-unit.c b/src/core/dbus-unit.c
52b84b
index aa15e47754..ce81103e92 100644
52b84b
--- a/src/core/dbus-unit.c
52b84b
+++ b/src/core/dbus-unit.c
52b84b
@@ -42,12 +42,14 @@ static BUS_DEFINE_PROPERTY_GET_ENUM(property_get_job_mode, job_mode, JobMode);
52b84b
 static BUS_DEFINE_PROPERTY_GET_ENUM(property_get_emergency_action, emergency_action, EmergencyAction);
52b84b
 static BUS_DEFINE_PROPERTY_GET(property_get_description, "s", Unit, unit_description);
52b84b
 static BUS_DEFINE_PROPERTY_GET2(property_get_active_state, "s", Unit, unit_active_state, unit_active_state_to_string);
52b84b
+static BUS_DEFINE_PROPERTY_GET2(property_get_freezer_state, "s", Unit, unit_freezer_state, freezer_state_to_string);
52b84b
 static BUS_DEFINE_PROPERTY_GET(property_get_sub_state, "s", Unit, unit_sub_state_to_string);
52b84b
 static BUS_DEFINE_PROPERTY_GET2(property_get_unit_file_state, "s", Unit, unit_get_unit_file_state, unit_file_state_to_string);
52b84b
 static BUS_DEFINE_PROPERTY_GET(property_get_can_reload, "b", Unit, unit_can_reload);
52b84b
 static BUS_DEFINE_PROPERTY_GET(property_get_can_start, "b", Unit, unit_can_start_refuse_manual);
52b84b
 static BUS_DEFINE_PROPERTY_GET(property_get_can_stop, "b", Unit, unit_can_stop_refuse_manual);
52b84b
 static BUS_DEFINE_PROPERTY_GET(property_get_can_isolate, "b", Unit, unit_can_isolate_refuse_manual);
52b84b
+static BUS_DEFINE_PROPERTY_GET(property_get_can_freeze, "b", Unit, unit_can_freeze);
52b84b
 static BUS_DEFINE_PROPERTY_GET(property_get_need_daemon_reload, "b", Unit, unit_need_daemon_reload);
52b84b
 static BUS_DEFINE_PROPERTY_GET_GLOBAL(property_get_empty_strv, "as", 0);
52b84b
 
52b84b
@@ -561,6 +563,79 @@ int bus_unit_method_unref(sd_bus_message *message, void *userdata, sd_bus_error
52b84b
         return sd_bus_reply_method_return(message, NULL);
52b84b
 }
52b84b
 
52b84b
+static int bus_unit_method_freezer_generic(sd_bus_message *message, void *userdata, sd_bus_error *error, FreezerAction action) {
52b84b
+        const char* perm;
52b84b
+        int (*method)(Unit*);
52b84b
+        Unit *u = userdata;
52b84b
+        bool reply_no_delay = false;
52b84b
+        int r;
52b84b
+
52b84b
+        assert(message);
52b84b
+        assert(u);
52b84b
+        assert(IN_SET(action, FREEZER_FREEZE, FREEZER_THAW));
52b84b
+
52b84b
+        if (action == FREEZER_FREEZE) {
52b84b
+                perm = "stop";
52b84b
+                method = unit_freeze;
52b84b
+        } else {
52b84b
+                perm = "start";
52b84b
+                method = unit_thaw;
52b84b
+        }
52b84b
+
52b84b
+        r = mac_selinux_unit_access_check(u, message, perm, error);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        r = bus_verify_manage_units_async_full(
52b84b
+                        u,
52b84b
+                        perm,
52b84b
+                        CAP_SYS_ADMIN,
52b84b
+                        N_("Authentication is required to freeze or thaw the processes of '$(unit)' unit."),
52b84b
+                        true,
52b84b
+                        message,
52b84b
+                        error);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+        if (r == 0)
52b84b
+                return 1; /* No authorization for now, but the async polkit stuff will call us again when it has it */
52b84b
+
52b84b
+        r = method(u);
52b84b
+        if (r == -EOPNOTSUPP)
52b84b
+                return sd_bus_error_setf(error, SD_BUS_ERROR_NOT_SUPPORTED, "Unit '%s' does not support freezing.", u->id);
52b84b
+        if (r == -EBUSY)
52b84b
+                return sd_bus_error_setf(error, BUS_ERROR_UNIT_BUSY, "Unit has a pending job.");
52b84b
+        if (r == -EHOSTDOWN)
52b84b
+                return sd_bus_error_setf(error, BUS_ERROR_UNIT_INACTIVE, "Unit is inactive.");
52b84b
+        if (r == -EALREADY)
52b84b
+                return sd_bus_error_setf(error, SD_BUS_ERROR_FAILED, "Previously requested freezer operation for unit '%s' is still in progress.", u->id);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+        if (r == 0)
52b84b
+                reply_no_delay = true;
52b84b
+
52b84b
+        assert(!u->pending_freezer_message);
52b84b
+
52b84b
+        r = sd_bus_message_new_method_return(message, &u->pending_freezer_message);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        if (reply_no_delay) {
52b84b
+                r = bus_unit_send_pending_freezer_message(u);
52b84b
+                if (r < 0)
52b84b
+                        return r;
52b84b
+        }
52b84b
+
52b84b
+        return 1;
52b84b
+}
52b84b
+
52b84b
+int bus_unit_method_thaw(sd_bus_message *message, void *userdata, sd_bus_error *error) {
52b84b
+        return bus_unit_method_freezer_generic(message, userdata, error, FREEZER_THAW);
52b84b
+}
52b84b
+
52b84b
+int bus_unit_method_freeze(sd_bus_message *message, void *userdata, sd_bus_error *error) {
52b84b
+        return bus_unit_method_freezer_generic(message, userdata, error, FREEZER_FREEZE);
52b84b
+}
52b84b
+
52b84b
 const sd_bus_vtable bus_unit_vtable[] = {
52b84b
         SD_BUS_VTABLE_START(0),
52b84b
 
52b84b
@@ -592,6 +667,7 @@ const sd_bus_vtable bus_unit_vtable[] = {
52b84b
         SD_BUS_PROPERTY("Description", "s", property_get_description, 0, SD_BUS_VTABLE_PROPERTY_CONST),
52b84b
         SD_BUS_PROPERTY("LoadState", "s", property_get_load_state, offsetof(Unit, load_state), SD_BUS_VTABLE_PROPERTY_CONST),
52b84b
         SD_BUS_PROPERTY("ActiveState", "s", property_get_active_state, 0, SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE),
52b84b
+        SD_BUS_PROPERTY("FreezerState", "s", property_get_freezer_state, 0, SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE),
52b84b
         SD_BUS_PROPERTY("SubState", "s", property_get_sub_state, 0, SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE),
52b84b
         SD_BUS_PROPERTY("FragmentPath", "s", NULL, offsetof(Unit, fragment_path), SD_BUS_VTABLE_PROPERTY_CONST),
52b84b
         SD_BUS_PROPERTY("SourcePath", "s", NULL, offsetof(Unit, source_path), SD_BUS_VTABLE_PROPERTY_CONST),
52b84b
@@ -607,6 +683,7 @@ const sd_bus_vtable bus_unit_vtable[] = {
52b84b
         SD_BUS_PROPERTY("CanStop", "b", property_get_can_stop, 0, SD_BUS_VTABLE_PROPERTY_CONST),
52b84b
         SD_BUS_PROPERTY("CanReload", "b", property_get_can_reload, 0, SD_BUS_VTABLE_PROPERTY_CONST),
52b84b
         SD_BUS_PROPERTY("CanIsolate", "b", property_get_can_isolate, 0, SD_BUS_VTABLE_PROPERTY_CONST),
52b84b
+        SD_BUS_PROPERTY("CanFreeze", "b", property_get_can_freeze, 0, SD_BUS_VTABLE_PROPERTY_CONST),
52b84b
         SD_BUS_PROPERTY("Job", "(uo)", property_get_job, offsetof(Unit, job), SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE),
52b84b
         SD_BUS_PROPERTY("StopWhenUnneeded", "b", bus_property_get_bool, offsetof(Unit, stop_when_unneeded), SD_BUS_VTABLE_PROPERTY_CONST),
52b84b
         SD_BUS_PROPERTY("RefuseManualStart", "b", bus_property_get_bool, offsetof(Unit, refuse_manual_start), SD_BUS_VTABLE_PROPERTY_CONST),
52b84b
@@ -650,6 +727,8 @@ const sd_bus_vtable bus_unit_vtable[] = {
52b84b
         SD_BUS_METHOD("SetProperties", "ba(sv)", NULL, bus_unit_method_set_properties, SD_BUS_VTABLE_UNPRIVILEGED),
52b84b
         SD_BUS_METHOD("Ref", NULL, NULL, bus_unit_method_ref, SD_BUS_VTABLE_UNPRIVILEGED),
52b84b
         SD_BUS_METHOD("Unref", NULL, NULL, bus_unit_method_unref, SD_BUS_VTABLE_UNPRIVILEGED),
52b84b
+        SD_BUS_METHOD("Freeze", NULL, NULL, bus_unit_method_freeze, SD_BUS_VTABLE_UNPRIVILEGED),
52b84b
+        SD_BUS_METHOD("Thaw", NULL, NULL, bus_unit_method_thaw, SD_BUS_VTABLE_UNPRIVILEGED),
52b84b
 
52b84b
         /* For dependency types we don't support anymore always return an empty array */
52b84b
         SD_BUS_PROPERTY("RequiresOverridable", "as", property_get_empty_strv, 0, SD_BUS_VTABLE_HIDDEN),
52b84b
@@ -1209,6 +1288,23 @@ void bus_unit_send_change_signal(Unit *u) {
52b84b
         u->sent_dbus_new_signal = true;
52b84b
 }
52b84b
 
52b84b
+int bus_unit_send_pending_freezer_message(Unit *u) {
52b84b
+        int r;
52b84b
+
52b84b
+        assert(u);
52b84b
+
52b84b
+        if (!u->pending_freezer_message)
52b84b
+                return 0;
52b84b
+
52b84b
+        r = sd_bus_send(NULL, u->pending_freezer_message, NULL);
52b84b
+        if (r < 0)
52b84b
+                log_warning_errno(r, "Failed to send queued message, ignoring: %m");
52b84b
+
52b84b
+        u->pending_freezer_message = sd_bus_message_unref(u->pending_freezer_message);
52b84b
+
52b84b
+        return 0;
52b84b
+}
52b84b
+
52b84b
 static int send_removed_signal(sd_bus *bus, void *userdata) {
52b84b
         _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
52b84b
         _cleanup_free_ char *p = NULL;
52b84b
diff --git a/src/core/dbus-unit.h b/src/core/dbus-unit.h
52b84b
index 68eb621836..39aa1bb53c 100644
52b84b
--- a/src/core/dbus-unit.h
52b84b
+++ b/src/core/dbus-unit.h
52b84b
@@ -11,6 +11,7 @@ extern const sd_bus_vtable bus_unit_vtable[];
52b84b
 extern const sd_bus_vtable bus_unit_cgroup_vtable[];
52b84b
 
52b84b
 void bus_unit_send_change_signal(Unit *u);
52b84b
+int bus_unit_send_pending_freezer_message(Unit *u);
52b84b
 void bus_unit_send_removed_signal(Unit *u);
52b84b
 
52b84b
 int bus_unit_method_start_generic(sd_bus_message *message, Unit *u, JobType job_type, bool reload_if_possible, sd_bus_error *error);
52b84b
@@ -23,6 +24,8 @@ int bus_unit_method_get_processes(sd_bus_message *message, void *userdata, sd_bu
52b84b
 int bus_unit_method_attach_processes(sd_bus_message *message, void *userdata, sd_bus_error *error);
52b84b
 int bus_unit_method_ref(sd_bus_message *message, void *userdata, sd_bus_error *error);
52b84b
 int bus_unit_method_unref(sd_bus_message *message, void *userdata, sd_bus_error *error);
52b84b
+int bus_unit_method_freeze(sd_bus_message *message, void *userdata, sd_bus_error *error);
52b84b
+int bus_unit_method_thaw(sd_bus_message *message, void *userdata, sd_bus_error *error);
52b84b
 
52b84b
 int bus_unit_queue_job(sd_bus_message *message, Unit *u, JobType type, JobMode mode, bool reload_if_possible, sd_bus_error *error);
52b84b
 int bus_unit_validate_load_state(Unit *u, sd_bus_error *error);
52b84b
diff --git a/src/core/dbus.c b/src/core/dbus.c
52b84b
index 346a440c5d..b69c11c519 100644
52b84b
--- a/src/core/dbus.c
52b84b
+++ b/src/core/dbus.c
52b84b
@@ -1073,10 +1073,15 @@ static void destroy_bus(Manager *m, sd_bus **bus) {
52b84b
                 if (j->bus_track && sd_bus_track_get_bus(j->bus_track) == *bus)
52b84b
                         j->bus_track = sd_bus_track_unref(j->bus_track);
52b84b
 
52b84b
-        HASHMAP_FOREACH(u, m->units, i)
52b84b
+        HASHMAP_FOREACH(u, m->units, i) {
52b84b
                 if (u->bus_track && sd_bus_track_get_bus(u->bus_track) == *bus)
52b84b
                         u->bus_track = sd_bus_track_unref(u->bus_track);
52b84b
 
52b84b
+                /* Get rid of pending freezer messages on this bus */
52b84b
+                if (u->pending_freezer_message && sd_bus_message_get_bus(u->pending_freezer_message) == *bus)
52b84b
+                        u->pending_freezer_message = sd_bus_message_unref(u->pending_freezer_message);
52b84b
+        }
52b84b
+
52b84b
         /* Get rid of queued message on this bus */
52b84b
         if (m->pending_reload_message && sd_bus_message_get_bus(m->pending_reload_message) == *bus)
52b84b
                 m->pending_reload_message = sd_bus_message_unref(m->pending_reload_message);
52b84b
diff --git a/src/core/scope.c b/src/core/scope.c
52b84b
index a1a5363244..5a595c65a6 100644
52b84b
--- a/src/core/scope.c
52b84b
+++ b/src/core/scope.c
52b84b
@@ -601,6 +601,9 @@ const UnitVTable scope_vtable = {
52b84b
 
52b84b
         .kill = scope_kill,
52b84b
 
52b84b
+        .freeze = unit_freeze_vtable_common,
52b84b
+        .thaw = unit_thaw_vtable_common,
52b84b
+
52b84b
         .get_timeout = scope_get_timeout,
52b84b
 
52b84b
         .serialize = scope_serialize,
52b84b
diff --git a/src/core/service.c b/src/core/service.c
52b84b
index 1d98ee37fd..89b41f6783 100644
52b84b
--- a/src/core/service.c
52b84b
+++ b/src/core/service.c
52b84b
@@ -4143,6 +4143,9 @@ const UnitVTable service_vtable = {
52b84b
 
52b84b
         .kill = service_kill,
52b84b
 
52b84b
+        .freeze = unit_freeze_vtable_common,
52b84b
+        .thaw = unit_thaw_vtable_common,
52b84b
+
52b84b
         .serialize = service_serialize,
52b84b
         .deserialize_item = service_deserialize_item,
52b84b
 
52b84b
diff --git a/src/core/slice.c b/src/core/slice.c
52b84b
index 58f18a4dad..b5eb2f5c01 100644
52b84b
--- a/src/core/slice.c
52b84b
+++ b/src/core/slice.c
52b84b
@@ -344,6 +344,82 @@ static void slice_enumerate_perpetual(Manager *m) {
52b84b
                 (void) slice_make_perpetual(m, SPECIAL_SYSTEM_SLICE, NULL);
52b84b
 }
52b84b
 
52b84b
+static bool slice_freezer_action_supported_by_children(Unit *s) {
52b84b
+        Unit *member;
52b84b
+        void *v;
52b84b
+        Iterator i;
52b84b
+
52b84b
+        assert(s);
52b84b
+
52b84b
+        HASHMAP_FOREACH_KEY(v, member, s->dependencies[UNIT_BEFORE], i) {
52b84b
+                int r;
52b84b
+
52b84b
+                if (UNIT_DEREF(member->slice) != s)
52b84b
+                        continue;
52b84b
+
52b84b
+                if (member->type == UNIT_SLICE) {
52b84b
+                        r = slice_freezer_action_supported_by_children(member);
52b84b
+                        if (!r)
52b84b
+                                return r;
52b84b
+                }
52b84b
+
52b84b
+                if (!UNIT_VTABLE(member)->freeze)
52b84b
+                        return false;
52b84b
+        }
52b84b
+
52b84b
+        return true;
52b84b
+}
52b84b
+
52b84b
+static int slice_freezer_action(Unit *s, FreezerAction action) {
52b84b
+        Unit *member;
52b84b
+        void *v;
52b84b
+        Iterator i;
52b84b
+        int r;
52b84b
+
52b84b
+        assert(s);
52b84b
+        assert(IN_SET(action, FREEZER_FREEZE, FREEZER_THAW));
52b84b
+
52b84b
+        if (!slice_freezer_action_supported_by_children(s))
52b84b
+                return log_unit_warning(s, "Requested freezer operation is not supported by all children of the slice");
52b84b
+
52b84b
+        HASHMAP_FOREACH_KEY(v, member, s->dependencies[UNIT_BEFORE], i) {
52b84b
+                if (UNIT_DEREF(member->slice) != s)
52b84b
+                        continue;
52b84b
+
52b84b
+                if (action == FREEZER_FREEZE)
52b84b
+                        r = UNIT_VTABLE(member)->freeze(member);
52b84b
+                else
52b84b
+                        r = UNIT_VTABLE(member)->thaw(member);
52b84b
+
52b84b
+                if (r < 0)
52b84b
+                        return r;
52b84b
+        }
52b84b
+
52b84b
+        r = unit_cgroup_freezer_action(s, action);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        return 0;
52b84b
+}
52b84b
+
52b84b
+static int slice_freeze(Unit *s) {
52b84b
+        assert(s);
52b84b
+
52b84b
+        return slice_freezer_action(s, FREEZER_FREEZE);
52b84b
+}
52b84b
+
52b84b
+static int slice_thaw(Unit *s) {
52b84b
+        assert(s);
52b84b
+
52b84b
+        return slice_freezer_action(s, FREEZER_THAW);
52b84b
+}
52b84b
+
52b84b
+static bool slice_can_freeze(Unit *s) {
52b84b
+        assert(s);
52b84b
+
52b84b
+        return slice_freezer_action_supported_by_children(s);
52b84b
+}
52b84b
+
52b84b
 const UnitVTable slice_vtable = {
52b84b
         .object_size = sizeof(Slice),
52b84b
         .cgroup_context_offset = offsetof(Slice, cgroup_context),
52b84b
@@ -368,6 +444,10 @@ const UnitVTable slice_vtable = {
52b84b
 
52b84b
         .kill = slice_kill,
52b84b
 
52b84b
+        .freeze = slice_freeze,
52b84b
+        .thaw = slice_thaw,
52b84b
+        .can_freeze = slice_can_freeze,
52b84b
+
52b84b
         .serialize = slice_serialize,
52b84b
         .deserialize_item = slice_deserialize_item,
52b84b
 
52b84b
diff --git a/src/core/unit.c b/src/core/unit.c
52b84b
index f57260727f..29ce6c1fb7 100644
52b84b
--- a/src/core/unit.c
52b84b
+++ b/src/core/unit.c
52b84b
@@ -583,6 +583,7 @@ void unit_free(Unit *u) {
52b84b
         sd_bus_slot_unref(u->match_bus_slot);
52b84b
         sd_bus_track_unref(u->bus_track);
52b84b
         u->deserialized_refs = strv_free(u->deserialized_refs);
52b84b
+        u->pending_freezer_message = sd_bus_message_unref(u->pending_freezer_message);
52b84b
 
52b84b
         unit_free_requires_mounts_for(u);
52b84b
 
52b84b
@@ -685,6 +686,38 @@ void unit_free(Unit *u) {
52b84b
         free(u);
52b84b
 }
52b84b
 
52b84b
+FreezerState unit_freezer_state(Unit *u) {
52b84b
+        assert(u);
52b84b
+
52b84b
+        return u->freezer_state;
52b84b
+}
52b84b
+
52b84b
+int unit_freezer_state_kernel(Unit *u, FreezerState *ret) {
52b84b
+        char *values[1] = {};
52b84b
+        int r;
52b84b
+
52b84b
+        assert(u);
52b84b
+
52b84b
+        r = cg_get_keyed_attribute(SYSTEMD_CGROUP_CONTROLLER, u->cgroup_path, "cgroup.events",
52b84b
+                                   STRV_MAKE("frozen"), values);
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        r = _FREEZER_STATE_INVALID;
52b84b
+
52b84b
+        if (values[0])  {
52b84b
+                if (streq(values[0], "0"))
52b84b
+                        r = FREEZER_RUNNING;
52b84b
+                else if (streq(values[0], "1"))
52b84b
+                        r = FREEZER_FROZEN;
52b84b
+        }
52b84b
+
52b84b
+        free(values[0]);
52b84b
+        *ret = r;
52b84b
+
52b84b
+        return 0;
52b84b
+}
52b84b
+
52b84b
 UnitActiveState unit_active_state(Unit *u) {
52b84b
         assert(u);
52b84b
 
52b84b
@@ -1760,6 +1793,7 @@ int unit_start(Unit *u) {
52b84b
          * before it will start again. */
52b84b
 
52b84b
         unit_add_to_dbus_queue(u);
52b84b
+        unit_cgroup_freezer_action(u, FREEZER_THAW);
52b84b
 
52b84b
         return UNIT_VTABLE(u)->start(u);
52b84b
 }
52b84b
@@ -1812,6 +1846,7 @@ int unit_stop(Unit *u) {
52b84b
                 return -EBADR;
52b84b
 
52b84b
         unit_add_to_dbus_queue(u);
52b84b
+        unit_cgroup_freezer_action(u, FREEZER_THAW);
52b84b
 
52b84b
         return UNIT_VTABLE(u)->stop(u);
52b84b
 }
52b84b
@@ -1868,6 +1903,8 @@ int unit_reload(Unit *u) {
52b84b
                 return 0;
52b84b
         }
52b84b
 
52b84b
+        unit_cgroup_freezer_action(u, FREEZER_THAW);
52b84b
+
52b84b
         return UNIT_VTABLE(u)->reload(u);
52b84b
 }
52b84b
 
52b84b
@@ -3208,6 +3245,8 @@ int unit_serialize(Unit *u, FILE *f, FDSet *fds, bool serialize_jobs) {
52b84b
         if (!sd_id128_is_null(u->invocation_id))
52b84b
                 unit_serialize_item_format(u, f, "invocation-id", SD_ID128_FORMAT_STR, SD_ID128_FORMAT_VAL(u->invocation_id));
52b84b
 
52b84b
+        (void) unit_serialize_item_format(u, f, "freezer-state", "%s", freezer_state_to_string(unit_freezer_state(u)));
52b84b
+
52b84b
         bus_track_serialize(u->bus_track, f, "ref");
52b84b
 
52b84b
         for (m = 0; m < _CGROUP_IP_ACCOUNTING_METRIC_MAX; m++) {
52b84b
@@ -3574,6 +3613,16 @@ int unit_deserialize(Unit *u, FILE *f, FDSet *fds) {
52b84b
                                         log_unit_warning_errno(u, r, "Failed to set invocation ID for unit: %m");
52b84b
                         }
52b84b
 
52b84b
+                        continue;
52b84b
+                } else if (streq(l, "freezer-state")) {
52b84b
+                        FreezerState s;
52b84b
+
52b84b
+                        s = freezer_state_from_string(v);
52b84b
+                        if (s < 0)
52b84b
+                                log_unit_debug(u, "Failed to deserialize freezer-state '%s', ignoring.", v);
52b84b
+                        else
52b84b
+                                u->freezer_state = s;
52b84b
+
52b84b
                         continue;
52b84b
                 }
52b84b
 
52b84b
@@ -5507,6 +5556,80 @@ void unit_log_skip(Unit *u, const char *result) {
52b84b
                    "UNIT_RESULT=%s", result);
52b84b
 }
52b84b
 
52b84b
+bool unit_can_freeze(Unit *u) {
52b84b
+        assert(u);
52b84b
+
52b84b
+        if (UNIT_VTABLE(u)->can_freeze)
52b84b
+                return UNIT_VTABLE(u)->can_freeze(u);
52b84b
+
52b84b
+        return UNIT_VTABLE(u)->freeze;
52b84b
+}
52b84b
+
52b84b
+void unit_frozen(Unit *u) {
52b84b
+        assert(u);
52b84b
+
52b84b
+        u->freezer_state = FREEZER_FROZEN;
52b84b
+
52b84b
+        bus_unit_send_pending_freezer_message(u);
52b84b
+}
52b84b
+
52b84b
+void unit_thawed(Unit *u) {
52b84b
+        assert(u);
52b84b
+
52b84b
+        u->freezer_state = FREEZER_RUNNING;
52b84b
+
52b84b
+        bus_unit_send_pending_freezer_message(u);
52b84b
+}
52b84b
+
52b84b
+static int unit_freezer_action(Unit *u, FreezerAction action) {
52b84b
+        UnitActiveState s;
52b84b
+        int (*method)(Unit*);
52b84b
+        int r;
52b84b
+
52b84b
+        assert(u);
52b84b
+        assert(IN_SET(action, FREEZER_FREEZE, FREEZER_THAW));
52b84b
+
52b84b
+        method = action == FREEZER_FREEZE ? UNIT_VTABLE(u)->freeze : UNIT_VTABLE(u)->thaw;
52b84b
+        if (!method || !cg_freezer_supported())
52b84b
+                return -EOPNOTSUPP;
52b84b
+
52b84b
+        if (u->job)
52b84b
+                return -EBUSY;
52b84b
+
52b84b
+        if (u->load_state != UNIT_LOADED)
52b84b
+                return -EHOSTDOWN;
52b84b
+
52b84b
+        s = unit_active_state(u);
52b84b
+        if (s != UNIT_ACTIVE)
52b84b
+                return -EHOSTDOWN;
52b84b
+
52b84b
+        if (IN_SET(u->freezer_state, FREEZER_FREEZING, FREEZER_THAWING))
52b84b
+                return -EALREADY;
52b84b
+
52b84b
+        r = method(u);
52b84b
+        if (r <= 0)
52b84b
+                return r;
52b84b
+
52b84b
+        return 1;
52b84b
+}
52b84b
+
52b84b
+int unit_freeze(Unit *u) {
52b84b
+        return unit_freezer_action(u, FREEZER_FREEZE);
52b84b
+}
52b84b
+
52b84b
+int unit_thaw(Unit *u) {
52b84b
+        return unit_freezer_action(u, FREEZER_THAW);
52b84b
+}
52b84b
+
52b84b
+/* Wrappers around low-level cgroup freezer operations common for service and scope units */
52b84b
+int unit_freeze_vtable_common(Unit *u) {
52b84b
+        return unit_cgroup_freezer_action(u, FREEZER_FREEZE);
52b84b
+}
52b84b
+
52b84b
+int unit_thaw_vtable_common(Unit *u) {
52b84b
+        return unit_cgroup_freezer_action(u, FREEZER_THAW);
52b84b
+}
52b84b
+
52b84b
 static const char* const collect_mode_table[_COLLECT_MODE_MAX] = {
52b84b
         [COLLECT_INACTIVE] = "inactive",
52b84b
         [COLLECT_INACTIVE_OR_FAILED] = "inactive-or-failed",
52b84b
diff --git a/src/core/unit.h b/src/core/unit.h
52b84b
index b40ff9b961..6e37fd6f5a 100644
52b84b
--- a/src/core/unit.h
52b84b
+++ b/src/core/unit.h
52b84b
@@ -118,6 +118,9 @@ typedef struct Unit {
52b84b
         UnitLoadState load_state;
52b84b
         Unit *merged_into;
52b84b
 
52b84b
+        FreezerState freezer_state;
52b84b
+        sd_bus_message *pending_freezer_message;
52b84b
+
52b84b
         char *id; /* One name is special because we use it for identification. Points to an entry in the names set */
52b84b
         char *instance;
52b84b
 
52b84b
@@ -456,6 +459,11 @@ typedef struct UnitVTable {
52b84b
 
52b84b
         int (*kill)(Unit *u, KillWho w, int signo, sd_bus_error *error);
52b84b
 
52b84b
+        /* Freeze the unit */
52b84b
+        int (*freeze)(Unit *u);
52b84b
+        int (*thaw)(Unit *u);
52b84b
+        bool (*can_freeze)(Unit *u);
52b84b
+
52b84b
         bool (*can_reload)(Unit *u);
52b84b
 
52b84b
         /* Write all data that cannot be restored from other sources
52b84b
@@ -641,6 +649,8 @@ const char *unit_description(Unit *u) _pure_;
52b84b
 bool unit_has_name(Unit *u, const char *name);
52b84b
 
52b84b
 UnitActiveState unit_active_state(Unit *u);
52b84b
+FreezerState unit_freezer_state(Unit *u);
52b84b
+int unit_freezer_state_kernel(Unit *u, FreezerState *ret);
52b84b
 
52b84b
 const char* unit_sub_state_to_string(Unit *u);
52b84b
 
52b84b
@@ -814,6 +824,16 @@ void unit_log_failure(Unit *u, const char *result);
52b84b
  * after some execution, rather than succeeded or failed. */
52b84b
 void unit_log_skip(Unit *u, const char *result);
52b84b
 
52b84b
+bool unit_can_freeze(Unit *u);
52b84b
+int unit_freeze(Unit *u);
52b84b
+void unit_frozen(Unit *u);
52b84b
+
52b84b
+int unit_thaw(Unit *u);
52b84b
+void unit_thawed(Unit *u);
52b84b
+
52b84b
+int unit_freeze_vtable_common(Unit *u);
52b84b
+int unit_thaw_vtable_common(Unit *u);
52b84b
+
52b84b
 /* Macros which append UNIT= or USER_UNIT= to the message */
52b84b
 
52b84b
 #define log_unit_full(unit, level, error, ...)                          \
52b84b
diff --git a/src/libsystemd/sd-bus/bus-common-errors.h b/src/libsystemd/sd-bus/bus-common-errors.h
52b84b
index 3945c7f6ac..77da78d4d4 100644
52b84b
--- a/src/libsystemd/sd-bus/bus-common-errors.h
52b84b
+++ b/src/libsystemd/sd-bus/bus-common-errors.h
52b84b
@@ -30,6 +30,8 @@
52b84b
 #define BUS_ERROR_NO_SUCH_DYNAMIC_USER "org.freedesktop.systemd1.NoSuchDynamicUser"
52b84b
 #define BUS_ERROR_NOT_REFERENCED "org.freedesktop.systemd1.NotReferenced"
52b84b
 #define BUS_ERROR_DISK_FULL "org.freedesktop.systemd1.DiskFull"
52b84b
+#define BUS_ERROR_UNIT_BUSY "org.freedesktop.systemd1.UnitBusy"
52b84b
+#define BUS_ERROR_UNIT_INACTIVE "org.freedesktop.systemd1.UnitInactive"
52b84b
 
52b84b
 #define BUS_ERROR_NO_SUCH_MACHINE "org.freedesktop.machine1.NoSuchMachine"
52b84b
 #define BUS_ERROR_NO_SUCH_IMAGE "org.freedesktop.machine1.NoSuchImage"
52b84b
diff --git a/src/systemctl/systemctl.c b/src/systemctl/systemctl.c
52b84b
index e0db97e339..e963f19b0a 100644
52b84b
--- a/src/systemctl/systemctl.c
52b84b
+++ b/src/systemctl/systemctl.c
52b84b
@@ -27,6 +27,7 @@
52b84b
 #include "bus-message.h"
52b84b
 #include "bus-unit-util.h"
52b84b
 #include "bus-util.h"
52b84b
+#include "bus-wait-for-units.h"
52b84b
 #include "cgroup-show.h"
52b84b
 #include "cgroup-util.h"
52b84b
 #include "copy.h"
52b84b
@@ -3728,6 +3729,98 @@ static int kill_unit(int argc, char *argv[], void *userdata) {
52b84b
 
52b84b
         return r;
52b84b
 }
52b84b
+static int freeze_or_thaw_unit(int argc, char *argv[], void *userdata) {
52b84b
+        _cleanup_(bus_wait_for_units_freep) BusWaitForUnits *w = NULL;
52b84b
+        _cleanup_strv_free_ char **names = NULL;
52b84b
+        int r, ret = EXIT_SUCCESS;
52b84b
+        char **name;
52b84b
+        const char *method;
52b84b
+        sd_bus *bus;
52b84b
+
52b84b
+        r = acquire_bus(BUS_FULL, &bus;;
52b84b
+        if (r < 0)
52b84b
+                return r;
52b84b
+
52b84b
+        polkit_agent_open_maybe();
52b84b
+
52b84b
+        r = expand_names(bus, strv_skip(argv, 1), NULL, &names);
52b84b
+        if (r < 0)
52b84b
+                return log_error_errno(r, "Failed to expand names: %m");
52b84b
+
52b84b
+        if (!arg_no_block) {
52b84b
+                r = bus_wait_for_units_new(bus, &w);
52b84b
+                if (r < 0)
52b84b
+                        return log_error_errno(r, "Failed to allocate unit waiter: %m");
52b84b
+        }
52b84b
+
52b84b
+        if (streq(argv[0], "freeze"))
52b84b
+                method = "FreezeUnit";
52b84b
+        else if (streq(argv[0], "thaw"))
52b84b
+                method = "ThawUnit";
52b84b
+        else
52b84b
+                assert_not_reached("Unhandled method");
52b84b
+
52b84b
+        STRV_FOREACH(name, names) {
52b84b
+                _cleanup_(sd_bus_error_free) sd_bus_error error = SD_BUS_ERROR_NULL;
52b84b
+                _cleanup_(sd_bus_message_unrefp) sd_bus_message *m = NULL;
52b84b
+
52b84b
+                if (w) {
52b84b
+                        /* If we shall wait for the cleaning to complete, let's add a ref on the unit first */
52b84b
+                        r = sd_bus_call_method(
52b84b
+                                        bus,
52b84b
+                                        "org.freedesktop.systemd1",
52b84b
+                                        "/org/freedesktop/systemd1",
52b84b
+                                        "org.freedesktop.systemd1.Manager",
52b84b
+                                        "RefUnit",
52b84b
+                                        &error,
52b84b
+                                        NULL,
52b84b
+                                        "s", *name);
52b84b
+                        if (r < 0) {
52b84b
+                                log_error_errno(r, "Failed to add reference to unit %s: %s", *name, bus_error_message(&error, r));
52b84b
+                                if (ret == EXIT_SUCCESS)
52b84b
+                                        ret = r;
52b84b
+                                continue;
52b84b
+                        }
52b84b
+                }
52b84b
+
52b84b
+                r = sd_bus_message_new_method_call(
52b84b
+                                bus,
52b84b
+                                &m,
52b84b
+                                "org.freedesktop.systemd1",
52b84b
+                                "/org/freedesktop/systemd1",
52b84b
+                                "org.freedesktop.systemd1.Manager",
52b84b
+                                method);
52b84b
+                if (r < 0)
52b84b
+                        return bus_log_create_error(r);
52b84b
+
52b84b
+                r = sd_bus_message_append(m, "s", *name);
52b84b
+                if (r < 0)
52b84b
+                        return bus_log_create_error(r);
52b84b
+
52b84b
+                r = sd_bus_call(bus, m, 0, &error, NULL);
52b84b
+                if (r < 0) {
52b84b
+                        log_error_errno(r, "Failed to %s unit %s: %s", argv[0], *name, bus_error_message(&error, r));
52b84b
+                        if (ret == EXIT_SUCCESS) {
52b84b
+                                ret = r;
52b84b
+                                continue;
52b84b
+                        }
52b84b
+                }
52b84b
+
52b84b
+                if (w) {
52b84b
+                        r = bus_wait_for_units_add_unit(w, *name, BUS_WAIT_REFFED|BUS_WAIT_FOR_MAINTENANCE_END, NULL, NULL);
52b84b
+                        if (r < 0)
52b84b
+                                return log_error_errno(r, "Failed to watch unit %s: %m", *name);
52b84b
+                }
52b84b
+        }
52b84b
+
52b84b
+        r = bus_wait_for_units_run(w);
52b84b
+        if (r < 0)
52b84b
+                return log_error_errno(r, "Failed to wait for units: %m");
52b84b
+        if (r == BUS_WAIT_FAILURE)
52b84b
+                ret = EXIT_FAILURE;
52b84b
+
52b84b
+        return ret;
52b84b
+}
52b84b
 
52b84b
 typedef struct ExecStatusInfo {
52b84b
         char *name;
52b84b
@@ -3832,6 +3925,7 @@ typedef struct UnitStatusInfo {
52b84b
         const char *id;
52b84b
         const char *load_state;
52b84b
         const char *active_state;
52b84b
+        const char *freezer_state;
52b84b
         const char *sub_state;
52b84b
         const char *unit_file_state;
52b84b
         const char *unit_file_preset;
52b84b
@@ -3949,7 +4043,7 @@ static void print_status_info(
52b84b
                 bool *ellipsized) {
52b84b
 
52b84b
         char since1[FORMAT_TIMESTAMP_RELATIVE_MAX], since2[FORMAT_TIMESTAMP_MAX];
52b84b
-        const char *s1, *s2, *active_on, *active_off, *on, *off, *ss;
52b84b
+        const char *s1, *s2, *active_on, *active_off, *on, *off, *ss, *fs;
52b84b
         _cleanup_free_ char *formatted_path = NULL;
52b84b
         ExecStatusInfo *p;
52b84b
         usec_t timestamp;
52b84b
@@ -4056,6 +4150,10 @@ static void print_status_info(
52b84b
                 printf("   Active: %s%s%s",
52b84b
                        active_on, strna(i->active_state), active_off);
52b84b
 
52b84b
+        fs = !isempty(i->freezer_state) && !streq(i->freezer_state, "running") ? i->freezer_state : NULL;
52b84b
+        if (fs)
52b84b
+                printf(" %s(%s)%s", ansi_highlight_yellow(), fs, active_off);
52b84b
+
52b84b
         if (!isempty(i->result) && !streq(i->result, "success"))
52b84b
                 printf(" (Result: %s)", i->result);
52b84b
 
52b84b
@@ -4985,6 +5083,7 @@ static int show_one(
52b84b
                 { "Id",                             "s",              NULL,           offsetof(UnitStatusInfo, id)                                },
52b84b
                 { "LoadState",                      "s",              NULL,           offsetof(UnitStatusInfo, load_state)                        },
52b84b
                 { "ActiveState",                    "s",              NULL,           offsetof(UnitStatusInfo, active_state)                      },
52b84b
+                { "FreezerState",                   "s",              NULL,           offsetof(UnitStatusInfo, freezer_state)                     },
52b84b
                 { "SubState",                       "s",              NULL,           offsetof(UnitStatusInfo, sub_state)                         },
52b84b
                 { "UnitFileState",                  "s",              NULL,           offsetof(UnitStatusInfo, unit_file_state)                   },
52b84b
                 { "UnitFilePreset",                 "s",              NULL,           offsetof(UnitStatusInfo, unit_file_preset)                  },
52b84b
@@ -7139,6 +7238,8 @@ static void systemctl_help(void) {
52b84b
                "                                      if supported, otherwise restart\n"
52b84b
                "  isolate UNIT                        Start one unit and stop all others\n"
52b84b
                "  kill UNIT...                        Send signal to processes of a unit\n"
52b84b
+               "  freeze PATTERN...                   Freeze execution of unit processes\n"
52b84b
+               "  thaw PATTERN...                     Resume execution of a frozen unit\n"
52b84b
                "  is-active PATTERN...                Check whether units are active\n"
52b84b
                "  is-failed PATTERN...                Check whether units are failed\n"
52b84b
                "  status [PATTERN...|PID...]          Show runtime status of one or more units\n"
52b84b
@@ -8280,6 +8381,8 @@ static int systemctl_main(int argc, char *argv[]) {
52b84b
                 { "condrestart",           2,        VERB_ANY, VERB_ONLINE_ONLY, start_unit           }, /* For compatibility with RH */
52b84b
                 { "isolate",               2,        2,        VERB_ONLINE_ONLY, start_unit           },
52b84b
                 { "kill",                  2,        VERB_ANY, VERB_ONLINE_ONLY, kill_unit            },
52b84b
+                { "freeze",                2,        VERB_ANY, VERB_ONLINE_ONLY, freeze_or_thaw_unit  },
52b84b
+                { "thaw",                  2,        VERB_ANY, VERB_ONLINE_ONLY, freeze_or_thaw_unit  },
52b84b
                 { "is-active",             2,        VERB_ANY, VERB_ONLINE_ONLY, check_unit_active    },
52b84b
                 { "check",                 2,        VERB_ANY, VERB_ONLINE_ONLY, check_unit_active    }, /* deprecated alias of is-active */
52b84b
                 { "is-failed",             2,        VERB_ANY, VERB_ONLINE_ONLY, check_unit_failed    },