]>
Commit | Line | Data |
---|---|---|
03467c88 | 1 | /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/ |
8c6db833 | 2 | |
c2f1db8f | 3 | #pragma once |
8c6db833 LP |
4 | |
5 | /*** | |
6 | This file is part of systemd. | |
7 | ||
8 | Copyright 2010 Lennart Poettering | |
9 | ||
10 | systemd is free software; you can redistribute it and/or modify it | |
5430f7f2 LP |
11 | under the terms of the GNU Lesser General Public License as published by |
12 | the Free Software Foundation; either version 2.1 of the License, or | |
8c6db833 LP |
13 | (at your option) any later version. |
14 | ||
15 | systemd is distributed in the hope that it will be useful, but | |
16 | WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
5430f7f2 | 18 | Lesser General Public License for more details. |
8c6db833 | 19 | |
5430f7f2 | 20 | You should have received a copy of the GNU Lesser General Public License |
8c6db833 LP |
21 | along with systemd; If not, see <http://www.gnu.org/licenses/>. |
22 | ***/ | |
23 | ||
35d2e7ec | 24 | #include <dirent.h> |
11c3a366 TA |
25 | #include <stdbool.h> |
26 | #include <stdint.h> | |
71d35b6b TA |
27 | #include <stdio.h> |
28 | #include <sys/types.h> | |
c6c18be3 | 29 | |
f6a6225e | 30 | #include "def.h" |
71d35b6b | 31 | #include "set.h" |
11c3a366 TA |
32 | #include "hashmap.h" |
33 | #include "macro.h" | |
8c6db833 | 34 | |
efdb0237 LP |
35 | /* An enum of well known cgroup controllers */ |
36 | typedef enum CGroupController { | |
37 | CGROUP_CONTROLLER_CPU, | |
38 | CGROUP_CONTROLLER_CPUACCT, | |
39 | CGROUP_CONTROLLER_BLKIO, | |
40 | CGROUP_CONTROLLER_MEMORY, | |
3905f127 | 41 | CGROUP_CONTROLLER_DEVICES, |
03a7b521 | 42 | CGROUP_CONTROLLER_PIDS, |
32ee7d33 | 43 | CGROUP_CONTROLLER_NET_CLS, |
efdb0237 LP |
44 | _CGROUP_CONTROLLER_MAX, |
45 | _CGROUP_CONTROLLER_INVALID = -1, | |
46 | } CGroupController; | |
47 | ||
48 | #define CGROUP_CONTROLLER_TO_MASK(c) (1 << (c)) | |
49 | ||
4ad49000 | 50 | /* A bit mask of well known cgroup controllers */ |
efdb0237 LP |
51 | typedef enum CGroupMask { |
52 | CGROUP_MASK_CPU = CGROUP_CONTROLLER_TO_MASK(CGROUP_CONTROLLER_CPU), | |
53 | CGROUP_MASK_CPUACCT = CGROUP_CONTROLLER_TO_MASK(CGROUP_CONTROLLER_CPUACCT), | |
54 | CGROUP_MASK_BLKIO = CGROUP_CONTROLLER_TO_MASK(CGROUP_CONTROLLER_BLKIO), | |
55 | CGROUP_MASK_MEMORY = CGROUP_CONTROLLER_TO_MASK(CGROUP_CONTROLLER_MEMORY), | |
3905f127 | 56 | CGROUP_MASK_DEVICES = CGROUP_CONTROLLER_TO_MASK(CGROUP_CONTROLLER_DEVICES), |
03a7b521 | 57 | CGROUP_MASK_PIDS = CGROUP_CONTROLLER_TO_MASK(CGROUP_CONTROLLER_PIDS), |
32ee7d33 | 58 | CGROUP_MASK_NET_CLS = CGROUP_CONTROLLER_TO_MASK(CGROUP_CONTROLLER_NET_CLS), |
efdb0237 LP |
59 | _CGROUP_MASK_ALL = CGROUP_CONTROLLER_TO_MASK(_CGROUP_CONTROLLER_MAX) - 1 |
60 | } CGroupMask; | |
4ad49000 | 61 | |
d53d9474 LP |
62 | /* Special values for the cpu.shares attribute */ |
63 | #define CGROUP_CPU_SHARES_INVALID ((uint64_t) -1) | |
64 | #define CGROUP_CPU_SHARES_MIN UINT64_C(2) | |
65 | #define CGROUP_CPU_SHARES_MAX UINT64_C(262144) | |
66 | #define CGROUP_CPU_SHARES_DEFAULT UINT64_C(1024) | |
67 | ||
68 | static inline bool CGROUP_CPU_SHARES_IS_OK(uint64_t x) { | |
69 | return | |
70 | x == CGROUP_CPU_SHARES_INVALID || | |
71 | (x >= CGROUP_CPU_SHARES_MIN && x <= CGROUP_CPU_SHARES_MAX); | |
72 | } | |
73 | ||
74 | /* Special values for the blkio.weight attribute */ | |
75 | #define CGROUP_BLKIO_WEIGHT_INVALID ((uint64_t) -1) | |
76 | #define CGROUP_BLKIO_WEIGHT_MIN UINT64_C(10) | |
77 | #define CGROUP_BLKIO_WEIGHT_MAX UINT64_C(1000) | |
78 | #define CGROUP_BLKIO_WEIGHT_DEFAULT UINT64_C(500) | |
79 | ||
80 | static inline bool CGROUP_BLKIO_WEIGHT_IS_OK(uint64_t x) { | |
81 | return | |
82 | x == CGROUP_BLKIO_WEIGHT_INVALID || | |
83 | (x >= CGROUP_BLKIO_WEIGHT_MIN && x <= CGROUP_BLKIO_WEIGHT_MAX); | |
84 | } | |
85 | ||
5954c074 LP |
86 | /* |
87 | * General rules: | |
88 | * | |
89 | * We accept named hierarchies in the syntax "foo" and "name=foo". | |
90 | * | |
91 | * We expect that named hierarchies do not conflict in name with a | |
92 | * kernel hierarchy, modulo the "name=" prefix. | |
93 | * | |
94 | * We always generate "normalized" controller names, i.e. without the | |
95 | * "name=" prefix. | |
96 | * | |
97 | * We require absolute cgroup paths. When returning, we will always | |
98 | * generate paths with multiple adjacent / removed. | |
99 | */ | |
100 | ||
c6c18be3 | 101 | int cg_enumerate_processes(const char *controller, const char *path, FILE **_f); |
c6c18be3 LP |
102 | int cg_read_pid(FILE *f, pid_t *_pid); |
103 | ||
35d2e7ec LP |
104 | int cg_enumerate_subgroups(const char *controller, const char *path, DIR **_d); |
105 | int cg_read_subgroup(DIR *d, char **fn); | |
106 | ||
430c18ed LP |
107 | int cg_kill(const char *controller, const char *path, int sig, bool sigcont, bool ignore_self, Set *s); |
108 | int cg_kill_recursive(const char *controller, const char *path, int sig, bool sigcont, bool ignore_self, bool remove, Set *s); | |
8c6db833 | 109 | |
246aa6dd LP |
110 | int cg_migrate(const char *cfrom, const char *pfrom, const char *cto, const char *pto, bool ignore_self); |
111 | int cg_migrate_recursive(const char *cfrom, const char *pfrom, const char *cto, const char *pto, bool ignore_self, bool remove); | |
13b84ec7 | 112 | int cg_migrate_recursive_fallback(const char *cfrom, const char *pfrom, const char *cto, const char *pto, bool ignore_self, bool rem); |
35d2e7ec LP |
113 | |
114 | int cg_split_spec(const char *spec, char **controller, char **path); | |
7027ff61 | 115 | int cg_mangle_path(const char *path, char **result); |
8c6db833 LP |
116 | |
117 | int cg_get_path(const char *controller, const char *path, const char *suffix, char **fs); | |
3474ae3c | 118 | int cg_get_path_and_check(const char *controller, const char *path, const char *suffix, char **fs); |
7027ff61 LP |
119 | |
120 | int cg_pid_get_path(const char *controller, pid_t pid, char **path); | |
8c6db833 LP |
121 | |
122 | int cg_trim(const char *controller, const char *path, bool delete_root); | |
35d2e7ec | 123 | |
4ad49000 | 124 | int cg_rmdir(const char *controller, const char *path); |
8c6db833 | 125 | |
4ad49000 | 126 | int cg_create(const char *controller, const char *path); |
8c6db833 | 127 | int cg_attach(const char *controller, const char *path, pid_t pid); |
13b84ec7 | 128 | int cg_attach_fallback(const char *controller, const char *path, pid_t pid); |
8c6db833 LP |
129 | int cg_create_and_attach(const char *controller, const char *path, pid_t pid); |
130 | ||
4ad49000 | 131 | int cg_set_attribute(const char *controller, const char *path, const char *attribute, const char *value); |
934277fe | 132 | int cg_get_attribute(const char *controller, const char *path, const char *attribute, char **ret); |
4ad49000 | 133 | |
8c6db833 | 134 | int cg_set_group_access(const char *controller, const char *path, mode_t mode, uid_t uid, gid_t gid); |
4ad49000 | 135 | int cg_set_task_access(const char *controller, const char *path, mode_t mode, uid_t uid, gid_t gid); |
8c6db833 LP |
136 | |
137 | int cg_install_release_agent(const char *controller, const char *agent); | |
ad929bcc | 138 | int cg_uninstall_release_agent(const char *controller); |
8c6db833 | 139 | |
6f883237 LP |
140 | int cg_is_empty(const char *controller, const char *path); |
141 | int cg_is_empty_recursive(const char *controller, const char *path); | |
8c6db833 | 142 | |
7027ff61 | 143 | int cg_get_root_path(char **path); |
6c03089c | 144 | |
7027ff61 | 145 | int cg_path_get_session(const char *path, char **session); |
ae018d9b | 146 | int cg_path_get_owner_uid(const char *path, uid_t *uid); |
6c03089c LP |
147 | int cg_path_get_unit(const char *path, char **unit); |
148 | int cg_path_get_user_unit(const char *path, char **unit); | |
7027ff61 | 149 | int cg_path_get_machine_name(const char *path, char **machine); |
1021b21b | 150 | int cg_path_get_slice(const char *path, char **slice); |
329ac4bc | 151 | int cg_path_get_user_slice(const char *path, char **slice); |
7027ff61 | 152 | |
751bc6ac | 153 | int cg_shift_path(const char *cgroup, const char *cached_root, const char **shifted); |
e9174f29 | 154 | int cg_pid_get_path_shifted(pid_t pid, const char *cached_root, char **cgroup); |
6c03089c | 155 | |
7027ff61 | 156 | int cg_pid_get_session(pid_t pid, char **session); |
ae018d9b | 157 | int cg_pid_get_owner_uid(pid_t pid, uid_t *uid); |
ba1261bc | 158 | int cg_pid_get_unit(pid_t pid, char **unit); |
ef1673d1 | 159 | int cg_pid_get_user_unit(pid_t pid, char **unit); |
7027ff61 | 160 | int cg_pid_get_machine_name(pid_t pid, char **machine); |
1021b21b | 161 | int cg_pid_get_slice(pid_t pid, char **slice); |
329ac4bc | 162 | int cg_pid_get_user_slice(pid_t pid, char **slice); |
1f73f0f1 | 163 | |
7027ff61 | 164 | int cg_path_decode_unit(const char *cgroup, char **unit); |
96cde13a | 165 | |
ae018d9b | 166 | char *cg_escape(const char *p); |
44a6b1b6 | 167 | char *cg_unescape(const char *p) _pure_; |
78edb35a | 168 | |
185a0874 | 169 | bool cg_controller_is_valid(const char *p); |
a016b922 LP |
170 | |
171 | int cg_slice_to_path(const char *unit, char **ret); | |
4ad49000 | 172 | |
efdb0237 | 173 | typedef const char* (*cg_migrate_callback_t)(CGroupMask mask, void *userdata); |
03b90d4b | 174 | |
efdb0237 LP |
175 | int cg_create_everywhere(CGroupMask supported, CGroupMask mask, const char *path); |
176 | int cg_attach_everywhere(CGroupMask supported, const char *path, pid_t pid, cg_migrate_callback_t callback, void *userdata); | |
177 | int cg_attach_many_everywhere(CGroupMask supported, const char *path, Set* pids, cg_migrate_callback_t callback, void *userdata); | |
178 | int cg_migrate_everywhere(CGroupMask supported, const char *from, const char *to, cg_migrate_callback_t callback, void *userdata); | |
179 | int cg_trim_everywhere(CGroupMask supported, const char *path, bool delete_root); | |
180 | int cg_enable_everywhere(CGroupMask supported, CGroupMask mask, const char *p); | |
4ad49000 | 181 | |
efdb0237 | 182 | int cg_mask_supported(CGroupMask *ret); |
b12afc8c LP |
183 | |
184 | int cg_kernel_controllers(Set *controllers); | |
efdb0237 LP |
185 | |
186 | int cg_unified(void); | |
187 | void cg_unified_flush(void); | |
188 | ||
189 | bool cg_is_unified_wanted(void); | |
190 | bool cg_is_legacy_wanted(void); | |
191 | ||
192 | const char* cgroup_controller_to_string(CGroupController c) _const_; | |
193 | CGroupController cgroup_controller_from_string(const char *s) _pure_; | |
d53d9474 LP |
194 | |
195 | int cg_cpu_shares_parse(const char *s, uint64_t *ret); | |
196 | int cg_blkio_weight_parse(const char *s, uint64_t *ret); |