]>
Commit | Line | Data |
---|---|---|
cc73685d CB |
1 | /* SPDX-License-Identifier: LGPL-2.1+ */ |
2 | ||
f1a4a029 ÇO |
3 | #ifndef __LXC_CONF_H |
4 | #define __LXC_CONF_H | |
0ad19a3f | 5 | |
481f03ef CB |
6 | #include "config.h" |
7 | ||
9e99997b | 8 | #include <linux/magic.h> |
74a2b586 | 9 | #include <net/if.h> |
1a0e70ac | 10 | #include <netinet/in.h> |
d38dd64a CB |
11 | #include <stdbool.h> |
12 | #include <stdio.h> | |
b0a33c1e | 13 | #include <sys/param.h> |
8173e600 | 14 | #include <sys/types.h> |
9e99997b CB |
15 | #include <sys/vfs.h> |
16 | ||
4822319f | 17 | #include "attach_options.h" |
d84b26bc | 18 | #include "caps.h" |
d7f19646 | 19 | #include "compiler.h" |
87d0990c | 20 | #include "hlist.h" |
f2363e38 | 21 | #include "list.h" |
c3e3c21a | 22 | #include "lxcseccomp.h" |
ee91fa06 | 23 | #include "memory_utils.h" |
734a677e | 24 | #include "namespace.h" |
732375f5 | 25 | #include "ringbuf.h" |
d38dd64a | 26 | #include "start.h" |
734a677e | 27 | #include "state.h" |
4e86cad3 | 28 | #include "storage/storage.h" |
02efd041 | 29 | #include "string_utils.h" |
64a04c84 | 30 | #include "syscall_wrappers.h" |
0ed9b1bc | 31 | #include "terminal.h" |
e3b4c4c4 | 32 | |
d38dd64a CB |
33 | #if HAVE_SYS_RESOURCE_H |
34 | #include <sys/resource.h> | |
35 | #endif | |
36 | ||
769872f9 SH |
37 | #if HAVE_SCMP_FILTER_CTX |
38 | typedef void * scmp_filter_ctx; | |
39 | #endif | |
40 | ||
64a04c84 CB |
41 | typedef signed long personality_t; |
42 | ||
97e9cfa0 SH |
43 | /* worth moving to configure.ac? */ |
44 | #define subuidfile "/etc/subuid" | |
45 | #define subgidfile "/etc/subgid" | |
46 | ||
0ad19a3f | 47 | /* |
43654d34 CB |
48 | * Defines a generic struct to configure the control group. It is up to the |
49 | * programmer to specify the right subsystem. | |
ec64264d | 50 | * @subsystem : the targeted subsystem |
576f946d | 51 | * @value : the value to set |
54860ed0 CB |
52 | * @version : The version of the cgroup filesystem on which the controller |
53 | * resides. | |
43654d34 CB |
54 | * |
55 | * @controllers : The controllers to use for this container. | |
56 | * @dir : The name of the directory containing the container's cgroup. | |
57 | * Not that this is a per-container setting. | |
0ad19a3f | 58 | */ |
59 | struct lxc_cgroup { | |
43654d34 CB |
60 | union { |
61 | /* information about a specific controller */ | |
62 | struct /* controller */ { | |
54860ed0 | 63 | int version; |
43654d34 CB |
64 | char *subsystem; |
65 | char *value; | |
66 | }; | |
67 | ||
68 | /* meta information about cgroup configuration */ | |
69 | struct /* meta */ { | |
70 | char *controllers; | |
71 | char *dir; | |
a900cbaf | 72 | char *monitor_dir; |
7696c1f9 | 73 | char *monitor_pivot_dir; |
a900cbaf WB |
74 | char *container_dir; |
75 | char *namespace_dir; | |
9caee129 | 76 | bool relative; |
43654d34 CB |
77 | }; |
78 | }; | |
c9dbb8ed CB |
79 | |
80 | struct list_head head; | |
0ad19a3f | 81 | }; |
82 | ||
ee91fa06 CB |
83 | static void free_lxc_cgroup(struct lxc_cgroup *ptr) |
84 | { | |
85 | if (ptr) { | |
86 | free(ptr->subsystem); | |
87 | free(ptr->value); | |
88 | free_disarm(ptr); | |
89 | } | |
90 | } | |
91 | define_cleanup_function(struct lxc_cgroup *, free_lxc_cgroup); | |
92 | ||
c6d09e15 | 93 | #if !HAVE_SYS_RESOURCE_H |
3a0e314d | 94 | #define RLIM_INFINITY ((unsigned long)-1) |
c6d09e15 WB |
95 | struct rlimit { |
96 | unsigned long rlim_cur; | |
97 | unsigned long rlim_max; | |
223797c3 | 98 | struct list_head head; |
c6d09e15 WB |
99 | }; |
100 | #endif | |
3a0e314d | 101 | |
c6d09e15 WB |
102 | /* |
103 | * Defines a structure to configure resource limits to set via setrlimit(). | |
104 | * @resource : the resource name in lowercase without the RLIMIT_ prefix | |
105 | * @limit : the limit to set | |
106 | */ | |
107 | struct lxc_limit { | |
108 | char *resource; | |
109 | struct rlimit limit; | |
223797c3 | 110 | struct list_head head; |
c6d09e15 WB |
111 | }; |
112 | ||
8fa831e0 CB |
113 | static void free_lxc_limit(struct lxc_limit *ptr) |
114 | { | |
115 | if (ptr) { | |
631d2715 | 116 | free_disarm(ptr->resource); |
8fa831e0 CB |
117 | free_disarm(ptr); |
118 | } | |
119 | } | |
120 | define_cleanup_function(struct lxc_limit *, free_lxc_limit); | |
121 | ||
f6d3e3e4 SH |
122 | enum idtype { |
123 | ID_TYPE_UID, | |
124 | ID_TYPE_GID | |
125 | }; | |
126 | ||
7edd0540 L |
127 | /* |
128 | * Defines a structure to configure kernel parameters at runtime. | |
129 | * @key : the kernel parameters will be configured without the "lxc.sysctl" prefix | |
130 | * @value : the value to set | |
131 | */ | |
132 | struct lxc_sysctl { | |
133 | char *key; | |
134 | char *value; | |
ba9f9347 | 135 | struct list_head head; |
7edd0540 L |
136 | }; |
137 | ||
f10c80d2 CB |
138 | static void free_lxc_sysctl(struct lxc_sysctl *ptr) |
139 | { | |
140 | if (ptr) { | |
141 | free(ptr->key); | |
142 | free(ptr->value); | |
143 | free_disarm(ptr); | |
144 | } | |
145 | } | |
146 | define_cleanup_function(struct lxc_sysctl *, free_lxc_sysctl); | |
147 | ||
61d7a733 YT |
148 | /* |
149 | * Defines a structure to configure proc filesystem at runtime. | |
150 | * @filename : the proc filesystem will be configured without the "lxc.proc" prefix | |
151 | * @value : the value to set | |
152 | */ | |
153 | struct lxc_proc { | |
154 | char *filename; | |
155 | char *value; | |
91d04bf9 | 156 | struct list_head head; |
61d7a733 YT |
157 | }; |
158 | ||
83332c24 CB |
159 | static void free_lxc_proc(struct lxc_proc *ptr) |
160 | { | |
161 | if (ptr) { | |
162 | free(ptr->filename); | |
163 | free(ptr->value); | |
164 | free_disarm(ptr); | |
165 | } | |
166 | } | |
167 | define_cleanup_function(struct lxc_proc *, free_lxc_proc); | |
168 | ||
f6d3e3e4 SH |
169 | /* |
170 | * id_map is an id map entry. Form in confile is: | |
bdcbb6b3 CB |
171 | * lxc.idmap = u 0 9800 100 |
172 | * lxc.idmap = u 1000 9900 100 | |
173 | * lxc.idmap = g 0 9800 100 | |
174 | * lxc.idmap = g 1000 9900 100 | |
251d0d2a DE |
175 | * meaning the container can use uids and gids 0-99 and 1000-1099, |
176 | * with [ug]id 0 mapping to [ug]id 9800 on the host, and [ug]id 1000 to | |
177 | * [ug]id 9900 on the host. | |
f6d3e3e4 SH |
178 | */ |
179 | struct id_map { | |
180 | enum idtype idtype; | |
251d0d2a | 181 | unsigned long hostid, nsid, range; |
0589d744 | 182 | struct list_head head; |
f6d3e3e4 SH |
183 | }; |
184 | ||
0e4be3cf | 185 | /* Defines the number of tty configured and contains the |
a589434e | 186 | * instantiated ptys |
885766f5 | 187 | * @max = number of configured ttys |
b0a33c1e | 188 | */ |
189 | struct lxc_tty_info { | |
885766f5 CB |
190 | size_t max; |
191 | char *dir; | |
192 | char *tty_names; | |
2520facd | 193 | struct lxc_terminal_info *tty; |
b0a33c1e | 194 | }; |
195 | ||
0b932f9d CB |
196 | typedef enum lxc_mount_options_t { |
197 | LXC_MOUNT_CREATE_DIR = 0, | |
198 | LXC_MOUNT_CREATE_FILE = 1, | |
199 | LXC_MOUNT_OPTIONAL = 2, | |
200 | LXC_MOUNT_RELATIVE = 3, | |
f6815906 CB |
201 | LXC_MOUNT_IDMAP = 4, |
202 | LXC_MOUNT_MAX = 5, | |
0b932f9d CB |
203 | } lxc_mount_options_t; |
204 | ||
205 | __hidden extern const char *lxc_mount_options_info[LXC_MOUNT_MAX]; | |
206 | ||
207 | struct lxc_mount_options { | |
2df612d4 CB |
208 | unsigned int create_dir : 1; |
209 | unsigned int create_file : 1; | |
210 | unsigned int optional : 1; | |
211 | unsigned int relative : 1; | |
3eb23230 CB |
212 | unsigned int bind_recursively : 1; |
213 | unsigned int propagate_recursively : 1; | |
2df612d4 | 214 | unsigned int bind : 1; |
f6815906 | 215 | char userns_path[PATH_MAX]; |
423374e9 CB |
216 | unsigned long mnt_flags; |
217 | unsigned long prop_flags; | |
218 | char *data; | |
1b82d721 | 219 | struct lxc_mount_attr attr; |
e73af35b | 220 | char *raw_options; |
0b932f9d CB |
221 | }; |
222 | ||
13bb312d | 223 | /* Defines a structure to store the rootfs location, the |
33fcb7a0 | 224 | * optionals pivot_root, rootfs mount paths |
953db219 CB |
225 | * @path : the rootfs source (directory or device) |
226 | * @mount : where it is mounted | |
952b5031 | 227 | * @buf : static buffer to construct paths |
953db219 | 228 | * @bev_type : optional backing store type |
953db219 | 229 | * @managed : whether it is managed by LXC |
ea57e424 | 230 | * @dfd_mnt : fd for @mount |
a5a08920 | 231 | * @dfd_dev : fd for /dev of the container |
33fcb7a0 DL |
232 | */ |
233 | struct lxc_rootfs { | |
ea11a215 | 234 | int dfd_host; |
79ff643d | 235 | |
33fcb7a0 | 236 | char *path; |
79ff643d | 237 | int fd_path_pin; |
4b875ef9 | 238 | int dfd_idmapped; |
79ff643d CB |
239 | |
240 | int dfd_mnt; | |
23b7ea69 | 241 | char *mount; |
79ff643d CB |
242 | |
243 | int dfd_dev; | |
244 | ||
952b5031 | 245 | char buf[PATH_MAX]; |
b3b8c97f | 246 | char *bdev_type; |
6e54330c | 247 | bool managed; |
0b932f9d | 248 | struct lxc_mount_options mnt_opts; |
4e86cad3 | 249 | struct lxc_storage *storage; |
33fcb7a0 DL |
250 | }; |
251 | ||
368bbc02 CS |
252 | /* |
253 | * Automatic mounts for LXC to perform inside the container | |
254 | */ | |
255 | enum { | |
62054cf3 CB |
256 | /* /proc read-write */ |
257 | LXC_AUTO_PROC_RW = BIT(0), | |
258 | /* /proc/sys and /proc/sysrq-trigger read-only */ | |
259 | LXC_AUTO_PROC_MIXED = BIT(1), | |
260 | LXC_AUTO_PROC_MASK = LXC_AUTO_PROC_RW | | |
261 | LXC_AUTO_PROC_MIXED, | |
262 | /* /sys read-write */ | |
263 | LXC_AUTO_SYS_RW = BIT(2), | |
264 | /* /sys read-only */ | |
265 | LXC_AUTO_SYS_RO = BIT(3), | |
266 | /* /sys read-only and /sys/class/net read-write */ | |
267 | LXC_AUTO_SYS_MIXED = LXC_AUTO_SYS_RW | | |
268 | LXC_AUTO_SYS_RO, | |
269 | LXC_AUTO_SYS_MASK = LXC_AUTO_SYS_MIXED, | |
270 | ||
271 | /* /sys/fs/cgroup (partial mount, read-only) */ | |
272 | LXC_AUTO_CGROUP_RO = BIT(4), | |
273 | /* /sys/fs/cgroup (partial mount, read-write) */ | |
274 | LXC_AUTO_CGROUP_RW = BIT(5), | |
275 | /* /sys/fs/cgroup (partial mount, paths r/o, cgroup r/w) */ | |
276 | LXC_AUTO_CGROUP_MIXED = LXC_AUTO_CGROUP_RO | | |
277 | LXC_AUTO_CGROUP_RW, | |
278 | /* /sys/fs/cgroup (full mount, read-only) */ | |
279 | LXC_AUTO_CGROUP_FULL_RO = BIT(6), | |
280 | /* /sys/fs/cgroup (full mount, read-write) */ | |
281 | LXC_AUTO_CGROUP_FULL_RW = BIT(7), | |
282 | /* /sys/fs/cgroup (full mount, parent r/o, own r/w) */ | |
283 | LXC_AUTO_CGROUP_FULL_MIXED = LXC_AUTO_CGROUP_FULL_RO | | |
284 | LXC_AUTO_CGROUP_FULL_RW, | |
d90d3007 CB |
285 | |
286 | /* | |
287 | * Mount a pure read-write cgroup2 layout in the container independent | |
288 | * of the cgroup layout used on the host. | |
289 | */ | |
290 | LXC_AUTO_CGROUP2_RW = BIT(8), | |
291 | /* | |
292 | * Mount a pure read-only cgroup2 layout in the container independent | |
293 | * of the cgroup layout used on the host. | |
294 | */ | |
295 | LXC_AUTO_CGROUP2_RO = BIT(9), | |
296 | ||
3a0e314d CB |
297 | /* |
298 | * These are defined in such a way as to retain binary compatibility | |
299 | * with earlier versions of this code. If the previous mask is applied, | |
300 | * both of these will default back to the _MIXED variants, which is | |
301 | * safe. | |
302 | */ | |
62054cf3 CB |
303 | /* /sys/fs/cgroup (partial mount, r/w or mixed, depending on caps) */ |
304 | LXC_AUTO_CGROUP_NOSPEC = 0x0B0, | |
305 | /* /sys/fs/cgroup (full mount, r/w or mixed, depending on caps) */ | |
306 | LXC_AUTO_CGROUP_FULL_NOSPEC = 0x0E0, | |
307 | /* mount cgroups even when cgroup namespaces are supported */ | |
d90d3007 | 308 | LXC_AUTO_CGROUP_FORCE = BIT(10), |
62054cf3 CB |
309 | /* all known cgroup options */ |
310 | LXC_AUTO_CGROUP_MASK = LXC_AUTO_CGROUP_MIXED | | |
311 | LXC_AUTO_CGROUP_FULL_MIXED | | |
312 | LXC_AUTO_CGROUP_NOSPEC | | |
313 | LXC_AUTO_CGROUP_FULL_NOSPEC | | |
d90d3007 CB |
314 | LXC_AUTO_CGROUP_FORCE | |
315 | LXC_AUTO_CGROUP2_RW | | |
316 | LXC_AUTO_CGROUP2_RO, | |
62054cf3 CB |
317 | |
318 | /* shared mount point */ | |
d90d3007 | 319 | LXC_AUTO_SHMOUNTS = BIT(11), |
62054cf3 CB |
320 | /* shared mount point mask */ |
321 | LXC_AUTO_SHMOUNTS_MASK = LXC_AUTO_SHMOUNTS, | |
322 | ||
323 | /* all known settings */ | |
324 | LXC_AUTO_ALL_MASK = LXC_AUTO_PROC_MASK | | |
325 | LXC_AUTO_SYS_MASK | | |
326 | LXC_AUTO_CGROUP_MASK, | |
368bbc02 CS |
327 | }; |
328 | ||
26ddeedd | 329 | enum lxchooks { |
1a0e70ac CB |
330 | LXCHOOK_PRESTART, |
331 | LXCHOOK_PREMOUNT, | |
332 | LXCHOOK_MOUNT, | |
333 | LXCHOOK_AUTODEV, | |
334 | LXCHOOK_START, | |
335 | LXCHOOK_STOP, | |
336 | LXCHOOK_POSTSTOP, | |
337 | LXCHOOK_CLONE, | |
338 | LXCHOOK_DESTROY, | |
08dd2805 | 339 | LXCHOOK_START_HOST, |
1a0e70ac CB |
340 | NUM_LXC_HOOKS |
341 | }; | |
72d0e1cb | 342 | |
59eac805 | 343 | __hidden extern char *lxchook_names[NUM_LXC_HOOKS]; |
7b35f3d6 | 344 | |
d39b10eb CB |
345 | struct lxc_state_client { |
346 | int clientfd; | |
347 | lxc_state_t states[MAX_STATE]; | |
d2e75eba | 348 | struct list_head head; |
d39b10eb CB |
349 | }; |
350 | ||
4b9dc703 | 351 | typedef enum lxc_bpf_devices_rule_t { |
4b9dc703 CB |
352 | LXC_BPF_DEVICE_CGROUP_ALLOWLIST = 0, |
353 | LXC_BPF_DEVICE_CGROUP_DENYLIST = 1, | |
354 | } lxc_bpf_devices_rule_t; | |
fda39d45 | 355 | |
4bfb655e CB |
356 | struct device_item { |
357 | char type; | |
358 | int major; | |
359 | int minor; | |
360 | char access[4]; | |
361 | int allow; | |
93de768e | 362 | struct list_head head; |
a134099d CB |
363 | }; |
364 | ||
365 | struct bpf_devices { | |
366 | lxc_bpf_devices_rule_t list_type; | |
93de768e | 367 | struct list_head devices; |
4bfb655e CB |
368 | }; |
369 | ||
70fd7fc9 CB |
370 | struct timens_offsets { |
371 | /* Currently, either s_boot or ns_boot is set, but not both. */ | |
372 | int64_t s_boot; | |
373 | int64_t ns_boot; | |
374 | ||
375 | /* Currently, either s_monotonic or ns_monotonic is set, but not both. */ | |
376 | int64_t s_monotonic; | |
377 | int64_t ns_monotonic; | |
378 | }; | |
379 | ||
c294a68d CB |
380 | struct environment_entry { |
381 | char *key; | |
382 | char *val; | |
383 | struct list_head head; | |
384 | }; | |
385 | ||
20ab7578 CB |
386 | struct cap_entry { |
387 | char *cap_name; | |
7418b27f | 388 | __u32 cap; |
20ab7578 CB |
389 | struct list_head head; |
390 | }; | |
391 | ||
392 | struct caps { | |
393 | int keep; | |
394 | struct list_head list; | |
395 | }; | |
396 | ||
be0bc4d1 CB |
397 | struct string_entry { |
398 | char *val; | |
399 | struct list_head head; | |
400 | }; | |
401 | ||
571e6ec8 | 402 | struct lxc_conf { |
c7b17051 CB |
403 | /* Pointer to the name of the container. Do not free! */ |
404 | const char *name; | |
07c4ea31 | 405 | bool is_execute; |
91480a0f | 406 | int reboot; |
64a04c84 | 407 | personality_t personality; |
571e6ec8 | 408 | struct utsname *utsname; |
edd64e17 | 409 | |
54860ed0 | 410 | struct { |
c9dbb8ed CB |
411 | struct list_head cgroup; |
412 | struct list_head cgroup2; | |
a134099d | 413 | struct bpf_devices bpf_devices; |
54860ed0 | 414 | }; |
edd64e17 | 415 | |
46ad64ab | 416 | struct { |
0589d744 | 417 | struct list_head id_map; |
c7e345ae | 418 | |
edd64e17 CB |
419 | /* |
420 | * Pointer to the idmap entry for the container's root uid in | |
421 | * the id_map list. Do not free! | |
422 | */ | |
5173b710 | 423 | const struct id_map *root_nsuid_map; |
c7e345ae | 424 | |
edd64e17 CB |
425 | /* |
426 | * Pointer to the idmap entry for the container's root gid in | |
427 | * the id_map list. Do not free! | |
428 | */ | |
5173b710 | 429 | const struct id_map *root_nsgid_map; |
46ad64ab | 430 | }; |
edd64e17 | 431 | |
87d0990c | 432 | struct list_head netdevs; |
448d7b0c CB |
433 | |
434 | struct { | |
435 | char *fstab; | |
436 | int auto_mounts; | |
be0bc4d1 | 437 | struct list_head mount_entries; |
448d7b0c CB |
438 | }; |
439 | ||
20ab7578 | 440 | struct caps caps; |
885766f5 | 441 | |
a2db71c0 | 442 | /* /dev/tty<idx> devices */ |
885766f5 | 443 | struct lxc_tty_info ttys; |
a2db71c0 CB |
444 | /* /dev/console device */ |
445 | struct lxc_terminal console; | |
446 | /* maximum pty devices allowed by devpts mount */ | |
e528c735 | 447 | size_t pty_max; |
f797f05e CB |
448 | /* file descriptor for the container's /dev/pts mount */ |
449 | int devpts_fd; | |
885766f5 | 450 | |
32fd6cf3 CB |
451 | /* set to true when rootfs has been setup */ |
452 | bool rootfs_setup; | |
33fcb7a0 | 453 | struct lxc_rootfs rootfs; |
32fd6cf3 | 454 | |
b3187a81 | 455 | bool close_all_fds; |
44ae0fb6 CB |
456 | |
457 | struct { | |
458 | unsigned int hooks_version; | |
5090de3e | 459 | struct list_head hooks[NUM_LXC_HOOKS]; |
44ae0fb6 | 460 | }; |
4a85ce2a | 461 | |
fe4de9a6 | 462 | char *lsm_aa_profile; |
1800f924 WB |
463 | char *lsm_aa_profile_computed; |
464 | bool lsm_aa_profile_created; | |
465 | unsigned int lsm_aa_allow_nesting; | |
a56e2df9 | 466 | unsigned int lsm_aa_allow_incomplete; |
1fb1e667 | 467 | struct list_head lsm_aa_raw; |
fe4de9a6 | 468 | char *lsm_se_context; |
4fef78bc | 469 | char *lsm_se_keyring_context; |
8f818a84 | 470 | bool keyring_disable_session; |
952b5031 | 471 | bool transient_procfs_mnt; |
c3e3c21a | 472 | struct lxc_seccomp seccomp; |
72d0e1cb | 473 | int maincmd_fd; |
1a0e70ac | 474 | unsigned int autodev; /* if 1, mount and fill a /dev at start */ |
63012bdd | 475 | int autodevtmpfssize; /* size of the /dev tmpfs */ |
1a0e70ac CB |
476 | int haltsignal; /* signal used to halt container */ |
477 | int rebootsignal; /* signal used to reboot container */ | |
478 | int stopsignal; /* signal used to hard stop container */ | |
479 | char *rcfile; /* Copy of the top level rcfile we read */ | |
480 | ||
b9949538 | 481 | /* Logfile and loglevel can be set in a container config file. Those |
7b660465 | 482 | * function as defaults. The defaults can be overridden by command line. |
1a0e70ac CB |
483 | * However we don't want the command line specified values to be saved |
484 | * on c->save_config(). So we store the config file specified values | |
485 | * here. */ | |
98020c31 JS |
486 | char *logfile; /* the logfile as specified in config */ |
487 | int loglevel; /* loglevel as specified in config (if any) */ | |
858377e4 | 488 | int logfd; |
9f30a190 | 489 | |
3590152f CB |
490 | unsigned int start_auto; |
491 | unsigned int start_delay; | |
ee1e7aa0 | 492 | int start_order; |
ffb2a35f | 493 | struct list_head groups; |
76a26f55 | 494 | int nbd_idx; |
35120d9c | 495 | |
a8dfe4e0 | 496 | /* unshare the mount namespace in the monitor */ |
226dc30e | 497 | unsigned int monitor_unshare; |
258f8051 | 498 | unsigned int monitor_signal_pdeath; |
a8dfe4e0 | 499 | |
7c661726 MP |
500 | /* list of environment variables we'll add to the container when |
501 | * started */ | |
c294a68d | 502 | struct list_head environment; |
6b0d5538 SH |
503 | |
504 | /* text representation of the config file */ | |
505 | char *unexpanded_config; | |
32fd6cf3 CB |
506 | size_t unexpanded_len; |
507 | size_t unexpanded_alloced; | |
67c660d0 | 508 | |
5cda27c1 SH |
509 | /* default command for lxc-execute */ |
510 | char *execute_cmd; | |
511 | ||
67c660d0 SG |
512 | /* init command */ |
513 | char *init_cmd; | |
56f8ff00 | 514 | |
4822319f | 515 | /* The uid to use for the container. */ |
c5cd20ce | 516 | uid_t init_uid; |
4822319f | 517 | /* The gid to use for the container. */ |
c5cd20ce | 518 | gid_t init_gid; |
4822319f CB |
519 | /* The groups to use for the container. */ |
520 | lxc_groups_t init_groups; | |
8796becf CB |
521 | |
522 | /* indicator if the container will be destroyed on shutdown */ | |
66ffdb1a | 523 | unsigned int ephemeral; |
76d0127f CB |
524 | |
525 | /* The facility to pass to syslog. Let's users establish as what type of | |
526 | * program liblxc is supposed to write to the syslog. */ | |
527 | char *syslog; | |
5a46f283 CB |
528 | |
529 | /* Whether PR_SET_NO_NEW_PRIVS will be set for the container. */ | |
530 | bool no_new_privs; | |
c6d09e15 WB |
531 | |
532 | /* RLIMIT_* limits */ | |
223797c3 | 533 | struct list_head limits; |
7ec2e32a | 534 | |
43654d34 CB |
535 | /* Contains generic info about the cgroup configuration for this |
536 | * container. Note that struct lxc_cgroup contains a union. It is only | |
537 | * valid to access the members of the anonymous "meta" struct within | |
538 | * that union. | |
539 | */ | |
540 | struct lxc_cgroup cgroup_meta; | |
28d9e29e | 541 | |
b074bbf1 | 542 | struct { |
1d8d3676 | 543 | int ns_clone; |
abeb5bba | 544 | int ns_keep; |
b074bbf1 CB |
545 | char *ns_share[LXC_NS_MAX]; |
546 | }; | |
3c491553 L |
547 | |
548 | /* init working directory */ | |
9e132956 | 549 | char *init_cwd; |
3c491553 | 550 | |
d39b10eb | 551 | /* A list of clients registered to be informed about a container state. */ |
d2e75eba | 552 | struct list_head state_clients; |
7edd0540 L |
553 | |
554 | /* sysctls */ | |
ba9f9347 | 555 | struct list_head sysctls; |
61d7a733 YT |
556 | |
557 | /* procs */ | |
91d04bf9 | 558 | struct list_head procs; |
adf0ba1f | 559 | |
7a41e857 | 560 | struct shmount { |
adf0ba1f LT |
561 | /* Absolute path to the shared mount point on the host */ |
562 | char *path_host; | |
563 | /* Absolute path (in the container) to the shared mount point */ | |
564 | char *path_cont; | |
7a41e857 | 565 | } shmount; |
70fd7fc9 CB |
566 | |
567 | struct timens_offsets timens; | |
09996a48 CB |
568 | |
569 | bool sched_core; | |
570 | __u64 sched_core_cookie; | |
571e6ec8 DL |
571 | }; |
572 | ||
efb7e304 CB |
573 | __hidden extern int write_id_mapping(enum idtype idtype, pid_t pid, const char *buf, size_t buf_size) |
574 | __access_r(3, 4); | |
344c9d81 | 575 | |
d7f19646 | 576 | extern thread_local struct lxc_conf *current_config; |
858377e4 | 577 | |
efb7e304 CB |
578 | __hidden extern int run_lxc_hooks(const char *name, char *hook, struct lxc_conf *conf, char *argv[]); |
579 | __hidden extern struct lxc_conf *lxc_conf_init(void); | |
580 | __hidden extern void lxc_conf_free(struct lxc_conf *conf); | |
4e86cad3 CB |
581 | __hidden extern int lxc_storage_prepare(struct lxc_conf *conf); |
582 | __hidden extern int lxc_rootfs_prepare(struct lxc_conf *conf, bool userns); | |
583 | __hidden extern void lxc_storage_put(struct lxc_conf *conf); | |
239f29c9 | 584 | __hidden extern int lxc_rootfs_init(struct lxc_conf *conf, bool userns); |
4b875ef9 | 585 | __hidden extern int lxc_rootfs_prepare_parent(struct lxc_handler *handler); |
1b82d721 | 586 | __hidden extern int lxc_idmapped_mounts_parent(struct lxc_handler *handler); |
0589d744 | 587 | __hidden extern int lxc_map_ids(struct list_head *idmap, pid_t pid); |
efb7e304 CB |
588 | __hidden extern int lxc_create_tty(const char *name, struct lxc_conf *conf); |
589 | __hidden extern void lxc_delete_tty(struct lxc_tty_info *ttys); | |
590 | __hidden extern int lxc_clear_config_caps(struct lxc_conf *c); | |
efb7e304 CB |
591 | __hidden extern int lxc_clear_cgroups(struct lxc_conf *c, const char *key, int version); |
592 | __hidden extern int lxc_clear_mount_entries(struct lxc_conf *c); | |
593 | __hidden extern int lxc_clear_automounts(struct lxc_conf *c); | |
594 | __hidden extern int lxc_clear_hooks(struct lxc_conf *c, const char *key); | |
595 | __hidden extern int lxc_clear_idmaps(struct lxc_conf *c); | |
596 | __hidden extern int lxc_clear_groups(struct lxc_conf *c); | |
597 | __hidden extern int lxc_clear_environment(struct lxc_conf *c); | |
598 | __hidden extern int lxc_clear_limits(struct lxc_conf *c, const char *key); | |
599 | __hidden extern int lxc_delete_autodev(struct lxc_handler *handler); | |
600 | __hidden extern int lxc_clear_autodev_tmpfs_size(struct lxc_conf *c); | |
efb7e304 CB |
601 | __hidden extern int lxc_setup_rootfs_prepare_root(struct lxc_conf *conf, const char *name, |
602 | const char *lxcpath); | |
603 | __hidden extern int lxc_setup(struct lxc_handler *handler); | |
604 | __hidden extern int lxc_setup_parent(struct lxc_handler *handler); | |
223797c3 | 605 | __hidden extern int setup_resource_limits(struct lxc_conf *conf, pid_t pid); |
efb7e304 CB |
606 | __hidden extern int find_unmapped_nsid(const struct lxc_conf *conf, enum idtype idtype); |
607 | __hidden extern int mapped_hostid(unsigned id, const struct lxc_conf *conf, enum idtype idtype); | |
608 | __hidden extern int userns_exec_1(const struct lxc_conf *conf, int (*fn)(void *), void *data, | |
609 | const char *fn_name); | |
610 | __hidden extern int userns_exec_full(struct lxc_conf *conf, int (*fn)(void *), void *data, | |
611 | const char *fn_name); | |
d94eb390 | 612 | __hidden extern int parse_mntopts_legacy(const char *mntopts, unsigned long *mntflags, char **mntdata); |
efb7e304 | 613 | __hidden extern int parse_propagationopts(const char *mntopts, unsigned long *pflags); |
1b82d721 | 614 | __hidden extern int parse_lxc_mount_attrs(struct lxc_mount_options *opts, char *mnt_opts); |
704cadd5 | 615 | __hidden extern int parse_mount_attrs(struct lxc_mount_options *opts, const char *mntopts); |
efb7e304 | 616 | __hidden extern void tmp_proc_unmount(struct lxc_conf *lxc_conf); |
efb7e304 | 617 | __hidden extern void suggest_default_idmap(void); |
be0bc4d1 CB |
618 | __hidden extern FILE *make_anonymous_mount_file(const struct list_head *mount, |
619 | bool include_nesting_helpers); | |
efb7e304 CB |
620 | __hidden extern int run_script(const char *name, const char *section, const char *script, ...); |
621 | __hidden extern int run_script_argv(const char *name, unsigned int hook_version, const char *section, | |
622 | const char *script, const char *hookname, char **argsin); | |
309ae287 | 623 | |
7418b27f CB |
624 | __hidden extern bool has_cap(__u32 cap, struct lxc_conf *conf); |
625 | static inline bool lxc_wants_cap(__u32 cap, struct lxc_conf *conf) | |
309ae287 | 626 | { |
7418b27f CB |
627 | __u32 last_cap; |
628 | int ret; | |
629 | ||
630 | ret = lxc_caps_last_cap(&last_cap); | |
631 | if (ret) | |
632 | return false; | |
633 | ||
634 | if (last_cap < cap) | |
d84b26bc CB |
635 | return false; |
636 | ||
20ab7578 | 637 | return has_cap(cap, conf); |
309ae287 CB |
638 | } |
639 | ||
ba9f9347 | 640 | __hidden extern int setup_sysctl_parameters(struct lxc_conf *conf); |
efb7e304 | 641 | __hidden extern int lxc_clear_sysctls(struct lxc_conf *c, const char *key); |
91d04bf9 | 642 | __hidden extern int setup_proc_filesystem(struct lxc_conf *conf, pid_t pid); |
efb7e304 CB |
643 | __hidden extern int lxc_clear_procs(struct lxc_conf *c, const char *key); |
644 | __hidden extern int lxc_clear_apparmor_raw(struct lxc_conf *c); | |
645 | __hidden extern int lxc_clear_namespace(struct lxc_conf *c); | |
646 | __hidden extern int userns_exec_minimal(const struct lxc_conf *conf, int (*fn_parent)(void *), | |
647 | void *fn_parent_data, int (*fn_child)(void *), | |
648 | void *fn_child_data); | |
649 | __hidden extern int userns_exec_mapped_root(const char *path, int path_fd, | |
650 | const struct lxc_conf *conf); | |
6e1a327a CB |
651 | static inline int chown_mapped_root(const char *path, const struct lxc_conf *conf) |
652 | { | |
653 | return userns_exec_mapped_root(path, -EBADF, conf); | |
654 | } | |
5ae72b98 | 655 | |
493ae3fe | 656 | __hidden extern int lxc_sync_fds_parent(struct lxc_handler *handler); |
111ed96e | 657 | __hidden extern int lxc_sync_fds_child(struct lxc_handler *handler); |
68f3899e | 658 | |
02efd041 CB |
659 | static inline const char *get_rootfs_mnt(const struct lxc_rootfs *rootfs) |
660 | { | |
661 | static const char *s = "/"; | |
662 | ||
663 | return !is_empty_string(rootfs->path) ? rootfs->mount : s; | |
664 | } | |
665 | ||
423374e9 CB |
666 | static inline void put_lxc_mount_options(struct lxc_mount_options *mnt_opts) |
667 | { | |
668 | mnt_opts->create_dir = 0; | |
669 | mnt_opts->create_file = 0; | |
670 | mnt_opts->optional = 0; | |
671 | mnt_opts->relative = 0; | |
672 | mnt_opts->userns_path[0] = '\0'; | |
673 | mnt_opts->mnt_flags = 0; | |
674 | mnt_opts->prop_flags = 0; | |
675 | ||
423374e9 | 676 | free_disarm(mnt_opts->data); |
e73af35b | 677 | free_disarm(mnt_opts->raw_options); |
423374e9 CB |
678 | } |
679 | ||
79ff643d CB |
680 | static inline void put_lxc_rootfs(struct lxc_rootfs *rootfs, bool unpin) |
681 | { | |
682 | if (rootfs) { | |
683 | close_prot_errno_disarm(rootfs->dfd_host); | |
684 | close_prot_errno_disarm(rootfs->dfd_mnt); | |
685 | close_prot_errno_disarm(rootfs->dfd_dev); | |
686 | if (unpin) | |
687 | close_prot_errno_disarm(rootfs->fd_path_pin); | |
4b875ef9 | 688 | close_prot_errno_disarm(rootfs->dfd_idmapped); |
423374e9 | 689 | put_lxc_mount_options(&rootfs->mnt_opts); |
4e86cad3 CB |
690 | storage_put(rootfs->storage); |
691 | rootfs->storage = NULL; | |
79ff643d CB |
692 | } |
693 | } | |
694 | ||
a7744f12 CB |
695 | static inline void lxc_clear_cgroup2_devices(struct bpf_devices *bpf_devices) |
696 | { | |
93de768e | 697 | struct device_item *device, *n; |
a7744f12 | 698 | |
93de768e CB |
699 | list_for_each_entry_safe(device, n, &bpf_devices->devices, head) |
700 | list_del(&device->head); | |
a7744f12 | 701 | |
93de768e | 702 | INIT_LIST_HEAD(&bpf_devices->devices); |
a7744f12 CB |
703 | } |
704 | ||
64a04c84 CB |
705 | static inline int lxc_personality(personality_t persona) |
706 | { | |
707 | if (persona < 0) | |
708 | return ret_errno(EINVAL); | |
709 | ||
710 | return personality(persona); | |
711 | } | |
712 | ||
c294a68d | 713 | __hidden extern int lxc_set_environment(const struct lxc_conf *conf); |
7418b27f | 714 | __hidden extern int parse_cap(const char *cap_name, __u32 *cap); |
c294a68d | 715 | |
1a0e70ac | 716 | #endif /* __LXC_CONF_H */ |