1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
6 #include "cgroup-util.h"
7 #include "cpu-set-util.h"
8 #include "ip-address-access.h"
10 #include "time-util.h"
12 typedef struct TasksMax
{
13 /* If scale == 0, just use value; otherwise, value / scale.
14 * See tasks_max_resolve(). */
19 #define TASKS_MAX_UNSET ((TasksMax) { .value = UINT64_MAX, .scale = 0 })
21 static inline bool tasks_max_isset(const TasksMax
*tasks_max
) {
22 return tasks_max
->value
!= UINT64_MAX
|| tasks_max
->scale
!= 0;
25 uint64_t tasks_max_resolve(const TasksMax
*tasks_max
);
27 typedef struct CGroupContext CGroupContext
;
28 typedef struct CGroupDeviceAllow CGroupDeviceAllow
;
29 typedef struct CGroupIODeviceWeight CGroupIODeviceWeight
;
30 typedef struct CGroupIODeviceLimit CGroupIODeviceLimit
;
31 typedef struct CGroupIODeviceLatency CGroupIODeviceLatency
;
32 typedef struct CGroupBlockIODeviceWeight CGroupBlockIODeviceWeight
;
33 typedef struct CGroupBlockIODeviceBandwidth CGroupBlockIODeviceBandwidth
;
35 typedef enum CGroupDevicePolicy
{
36 /* When devices listed, will allow those, plus built-in ones, if none are listed will allow
38 CGROUP_DEVICE_POLICY_AUTO
,
40 /* Everything forbidden, except built-in ones and listed ones. */
41 CGROUP_DEVICE_POLICY_CLOSED
,
43 /* Everything forbidden, except for the listed devices */
44 CGROUP_DEVICE_POLICY_STRICT
,
46 _CGROUP_DEVICE_POLICY_MAX
,
47 _CGROUP_DEVICE_POLICY_INVALID
= -1
50 typedef enum FreezerAction
{
55 _FREEZER_ACTION_INVALID
= -1,
58 struct CGroupDeviceAllow
{
59 LIST_FIELDS(CGroupDeviceAllow
, device_allow
);
66 struct CGroupIODeviceWeight
{
67 LIST_FIELDS(CGroupIODeviceWeight
, device_weights
);
72 struct CGroupIODeviceLimit
{
73 LIST_FIELDS(CGroupIODeviceLimit
, device_limits
);
75 uint64_t limits
[_CGROUP_IO_LIMIT_TYPE_MAX
];
78 struct CGroupIODeviceLatency
{
79 LIST_FIELDS(CGroupIODeviceLatency
, device_latencies
);
84 struct CGroupBlockIODeviceWeight
{
85 LIST_FIELDS(CGroupBlockIODeviceWeight
, device_weights
);
90 struct CGroupBlockIODeviceBandwidth
{
91 LIST_FIELDS(CGroupBlockIODeviceBandwidth
, device_bandwidths
);
97 struct CGroupContext
{
100 bool blockio_accounting
;
101 bool memory_accounting
;
102 bool tasks_accounting
;
105 /* Configures the memory.oom.group attribute (on unified) */
106 bool memory_oom_group
;
109 CGroupMask delegate_controllers
;
110 CGroupMask disable_controllers
;
112 /* For unified hierarchy */
114 uint64_t startup_cpu_weight
;
115 usec_t cpu_quota_per_sec_usec
;
116 usec_t cpu_quota_period_usec
;
122 uint64_t startup_io_weight
;
123 LIST_HEAD(CGroupIODeviceWeight
, io_device_weights
);
124 LIST_HEAD(CGroupIODeviceLimit
, io_device_limits
);
125 LIST_HEAD(CGroupIODeviceLatency
, io_device_latencies
);
127 uint64_t default_memory_min
;
128 uint64_t default_memory_low
;
131 uint64_t memory_high
;
133 uint64_t memory_swap_max
;
135 bool default_memory_min_set
;
136 bool default_memory_low_set
;
140 LIST_HEAD(IPAddressAccessItem
, ip_address_allow
);
141 LIST_HEAD(IPAddressAccessItem
, ip_address_deny
);
143 char **ip_filters_ingress
;
144 char **ip_filters_egress
;
146 /* For legacy hierarchies */
148 uint64_t startup_cpu_shares
;
150 uint64_t blockio_weight
;
151 uint64_t startup_blockio_weight
;
152 LIST_HEAD(CGroupBlockIODeviceWeight
, blockio_device_weights
);
153 LIST_HEAD(CGroupBlockIODeviceBandwidth
, blockio_device_bandwidths
);
155 uint64_t memory_limit
;
157 CGroupDevicePolicy device_policy
;
158 LIST_HEAD(CGroupDeviceAllow
, device_allow
);
163 /* Settings for systemd-oomd */
164 ManagedOOMMode moom_swap
;
165 ManagedOOMMode moom_mem_pressure
;
166 int moom_mem_pressure_limit
;
169 /* Used when querying IP accounting data */
170 typedef enum CGroupIPAccountingMetric
{
171 CGROUP_IP_INGRESS_BYTES
,
172 CGROUP_IP_INGRESS_PACKETS
,
173 CGROUP_IP_EGRESS_BYTES
,
174 CGROUP_IP_EGRESS_PACKETS
,
175 _CGROUP_IP_ACCOUNTING_METRIC_MAX
,
176 _CGROUP_IP_ACCOUNTING_METRIC_INVALID
= -1,
177 } CGroupIPAccountingMetric
;
179 /* Used when querying IO accounting data */
180 typedef enum CGroupIOAccountingMetric
{
181 CGROUP_IO_READ_BYTES
,
182 CGROUP_IO_WRITE_BYTES
,
183 CGROUP_IO_READ_OPERATIONS
,
184 CGROUP_IO_WRITE_OPERATIONS
,
185 _CGROUP_IO_ACCOUNTING_METRIC_MAX
,
186 _CGROUP_IO_ACCOUNTING_METRIC_INVALID
= -1,
187 } CGroupIOAccountingMetric
;
189 typedef struct Unit Unit
;
190 typedef struct Manager Manager
;
192 usec_t
cgroup_cpu_adjust_period(usec_t period
, usec_t quota
, usec_t resolution
, usec_t max_period
);
194 void cgroup_context_init(CGroupContext
*c
);
195 void cgroup_context_done(CGroupContext
*c
);
196 void cgroup_context_dump(Unit
*u
, FILE* f
, const char *prefix
);
198 void cgroup_context_free_device_allow(CGroupContext
*c
, CGroupDeviceAllow
*a
);
199 void cgroup_context_free_io_device_weight(CGroupContext
*c
, CGroupIODeviceWeight
*w
);
200 void cgroup_context_free_io_device_limit(CGroupContext
*c
, CGroupIODeviceLimit
*l
);
201 void cgroup_context_free_io_device_latency(CGroupContext
*c
, CGroupIODeviceLatency
*l
);
202 void cgroup_context_free_blockio_device_weight(CGroupContext
*c
, CGroupBlockIODeviceWeight
*w
);
203 void cgroup_context_free_blockio_device_bandwidth(CGroupContext
*c
, CGroupBlockIODeviceBandwidth
*b
);
205 int cgroup_add_device_allow(CGroupContext
*c
, const char *dev
, const char *mode
);
207 CGroupMask
unit_get_own_mask(Unit
*u
);
208 CGroupMask
unit_get_delegate_mask(Unit
*u
);
209 CGroupMask
unit_get_members_mask(Unit
*u
);
210 CGroupMask
unit_get_siblings_mask(Unit
*u
);
211 CGroupMask
unit_get_ancestor_disable_mask(Unit
*u
);
213 CGroupMask
unit_get_target_mask(Unit
*u
);
214 CGroupMask
unit_get_enable_mask(Unit
*u
);
216 void unit_invalidate_cgroup_members_masks(Unit
*u
);
218 void unit_add_family_to_cgroup_realize_queue(Unit
*u
);
220 const char *unit_get_realized_cgroup_path(Unit
*u
, CGroupMask mask
);
221 char *unit_default_cgroup_path(const Unit
*u
);
222 int unit_set_cgroup_path(Unit
*u
, const char *path
);
223 int unit_pick_cgroup_path(Unit
*u
);
225 int unit_realize_cgroup(Unit
*u
);
226 void unit_prune_cgroup(Unit
*u
);
227 int unit_watch_cgroup(Unit
*u
);
228 int unit_watch_cgroup_memory(Unit
*u
);
230 void unit_release_cgroup(Unit
*u
);
231 /* Releases the cgroup only if it is recursively empty.
232 * Returns true if the cgroup was released, false otherwise. */
233 bool unit_maybe_release_cgroup(Unit
*u
);
235 void unit_add_to_cgroup_empty_queue(Unit
*u
);
236 int unit_check_oomd_kill(Unit
*u
);
237 int unit_check_oom(Unit
*u
);
239 int unit_attach_pids_to_cgroup(Unit
*u
, Set
*pids
, const char *suffix_path
);
241 int manager_setup_cgroup(Manager
*m
);
242 void manager_shutdown_cgroup(Manager
*m
, bool delete);
244 unsigned manager_dispatch_cgroup_realize_queue(Manager
*m
);
246 Unit
*manager_get_unit_by_cgroup(Manager
*m
, const char *cgroup
);
247 Unit
*manager_get_unit_by_pid_cgroup(Manager
*m
, pid_t pid
);
248 Unit
* manager_get_unit_by_pid(Manager
*m
, pid_t pid
);
250 uint64_t unit_get_ancestor_memory_min(Unit
*u
);
251 uint64_t unit_get_ancestor_memory_low(Unit
*u
);
253 int unit_search_main_pid(Unit
*u
, pid_t
*ret
);
254 int unit_watch_all_pids(Unit
*u
);
256 int unit_synthesize_cgroup_empty_event(Unit
*u
);
258 int unit_get_memory_current(Unit
*u
, uint64_t *ret
);
259 int unit_get_tasks_current(Unit
*u
, uint64_t *ret
);
260 int unit_get_cpu_usage(Unit
*u
, nsec_t
*ret
);
261 int unit_get_io_accounting(Unit
*u
, CGroupIOAccountingMetric metric
, bool allow_cache
, uint64_t *ret
);
262 int unit_get_ip_accounting(Unit
*u
, CGroupIPAccountingMetric metric
, uint64_t *ret
);
264 int unit_reset_cpu_accounting(Unit
*u
);
265 int unit_reset_ip_accounting(Unit
*u
);
266 int unit_reset_io_accounting(Unit
*u
);
267 int unit_reset_accounting(Unit
*u
);
269 #define UNIT_CGROUP_BOOL(u, name) \
271 CGroupContext *cc = unit_get_cgroup_context(u); \
272 cc ? cc->name : false; \
275 bool manager_owns_host_root_cgroup(Manager
*m
);
276 bool unit_has_host_root_cgroup(Unit
*u
);
278 int manager_notify_cgroup_empty(Manager
*m
, const char *group
);
280 void unit_invalidate_cgroup(Unit
*u
, CGroupMask m
);
281 void unit_invalidate_cgroup_bpf(Unit
*u
);
283 void manager_invalidate_startup_units(Manager
*m
);
285 const char* cgroup_device_policy_to_string(CGroupDevicePolicy i
) _const_
;
286 CGroupDevicePolicy
cgroup_device_policy_from_string(const char *s
) _pure_
;
288 bool unit_cgroup_delegate(Unit
*u
);
290 int compare_job_priority(const void *a
, const void *b
);
292 int unit_get_cpuset(Unit
*u
, CPUSet
*cpus
, const char *name
);
293 int unit_cgroup_freezer_action(Unit
*u
, FreezerAction action
);
295 const char* freezer_action_to_string(FreezerAction a
) _const_
;
296 FreezerAction
freezer_action_from_string(const char *s
) _pure_
;