]>
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, | |
3a0e314d CB |
285 | /* |
286 | * These are defined in such a way as to retain binary compatibility | |
287 | * with earlier versions of this code. If the previous mask is applied, | |
288 | * both of these will default back to the _MIXED variants, which is | |
289 | * safe. | |
290 | */ | |
62054cf3 CB |
291 | /* /sys/fs/cgroup (partial mount, r/w or mixed, depending on caps) */ |
292 | LXC_AUTO_CGROUP_NOSPEC = 0x0B0, | |
293 | /* /sys/fs/cgroup (full mount, r/w or mixed, depending on caps) */ | |
294 | LXC_AUTO_CGROUP_FULL_NOSPEC = 0x0E0, | |
295 | /* mount cgroups even when cgroup namespaces are supported */ | |
296 | LXC_AUTO_CGROUP_FORCE = BIT(8), | |
297 | /* all known cgroup options */ | |
298 | LXC_AUTO_CGROUP_MASK = LXC_AUTO_CGROUP_MIXED | | |
299 | LXC_AUTO_CGROUP_FULL_MIXED | | |
300 | LXC_AUTO_CGROUP_NOSPEC | | |
301 | LXC_AUTO_CGROUP_FULL_NOSPEC | | |
302 | LXC_AUTO_CGROUP_FORCE, | |
303 | ||
304 | /* shared mount point */ | |
305 | LXC_AUTO_SHMOUNTS = BIT(9), | |
306 | /* shared mount point mask */ | |
307 | LXC_AUTO_SHMOUNTS_MASK = LXC_AUTO_SHMOUNTS, | |
308 | ||
309 | /* all known settings */ | |
310 | LXC_AUTO_ALL_MASK = LXC_AUTO_PROC_MASK | | |
311 | LXC_AUTO_SYS_MASK | | |
312 | LXC_AUTO_CGROUP_MASK, | |
368bbc02 CS |
313 | }; |
314 | ||
26ddeedd | 315 | enum lxchooks { |
1a0e70ac CB |
316 | LXCHOOK_PRESTART, |
317 | LXCHOOK_PREMOUNT, | |
318 | LXCHOOK_MOUNT, | |
319 | LXCHOOK_AUTODEV, | |
320 | LXCHOOK_START, | |
321 | LXCHOOK_STOP, | |
322 | LXCHOOK_POSTSTOP, | |
323 | LXCHOOK_CLONE, | |
324 | LXCHOOK_DESTROY, | |
08dd2805 | 325 | LXCHOOK_START_HOST, |
1a0e70ac CB |
326 | NUM_LXC_HOOKS |
327 | }; | |
72d0e1cb | 328 | |
59eac805 | 329 | __hidden extern char *lxchook_names[NUM_LXC_HOOKS]; |
7b35f3d6 | 330 | |
d39b10eb CB |
331 | struct lxc_state_client { |
332 | int clientfd; | |
333 | lxc_state_t states[MAX_STATE]; | |
d2e75eba | 334 | struct list_head head; |
d39b10eb CB |
335 | }; |
336 | ||
4b9dc703 | 337 | typedef enum lxc_bpf_devices_rule_t { |
4b9dc703 CB |
338 | LXC_BPF_DEVICE_CGROUP_ALLOWLIST = 0, |
339 | LXC_BPF_DEVICE_CGROUP_DENYLIST = 1, | |
340 | } lxc_bpf_devices_rule_t; | |
fda39d45 | 341 | |
4bfb655e CB |
342 | struct device_item { |
343 | char type; | |
344 | int major; | |
345 | int minor; | |
346 | char access[4]; | |
347 | int allow; | |
93de768e | 348 | struct list_head head; |
a134099d CB |
349 | }; |
350 | ||
351 | struct bpf_devices { | |
352 | lxc_bpf_devices_rule_t list_type; | |
93de768e | 353 | struct list_head devices; |
4bfb655e CB |
354 | }; |
355 | ||
70fd7fc9 CB |
356 | struct timens_offsets { |
357 | /* Currently, either s_boot or ns_boot is set, but not both. */ | |
358 | int64_t s_boot; | |
359 | int64_t ns_boot; | |
360 | ||
361 | /* Currently, either s_monotonic or ns_monotonic is set, but not both. */ | |
362 | int64_t s_monotonic; | |
363 | int64_t ns_monotonic; | |
364 | }; | |
365 | ||
c294a68d CB |
366 | struct environment_entry { |
367 | char *key; | |
368 | char *val; | |
369 | struct list_head head; | |
370 | }; | |
371 | ||
20ab7578 CB |
372 | struct cap_entry { |
373 | char *cap_name; | |
7418b27f | 374 | __u32 cap; |
20ab7578 CB |
375 | struct list_head head; |
376 | }; | |
377 | ||
378 | struct caps { | |
379 | int keep; | |
380 | struct list_head list; | |
381 | }; | |
382 | ||
be0bc4d1 CB |
383 | struct string_entry { |
384 | char *val; | |
385 | struct list_head head; | |
386 | }; | |
387 | ||
571e6ec8 | 388 | struct lxc_conf { |
c7b17051 CB |
389 | /* Pointer to the name of the container. Do not free! */ |
390 | const char *name; | |
07c4ea31 | 391 | bool is_execute; |
91480a0f | 392 | int reboot; |
64a04c84 | 393 | personality_t personality; |
571e6ec8 | 394 | struct utsname *utsname; |
edd64e17 | 395 | |
54860ed0 | 396 | struct { |
c9dbb8ed CB |
397 | struct list_head cgroup; |
398 | struct list_head cgroup2; | |
a134099d | 399 | struct bpf_devices bpf_devices; |
54860ed0 | 400 | }; |
edd64e17 | 401 | |
46ad64ab | 402 | struct { |
0589d744 | 403 | struct list_head id_map; |
c7e345ae | 404 | |
edd64e17 CB |
405 | /* |
406 | * Pointer to the idmap entry for the container's root uid in | |
407 | * the id_map list. Do not free! | |
408 | */ | |
5173b710 | 409 | const struct id_map *root_nsuid_map; |
c7e345ae | 410 | |
edd64e17 CB |
411 | /* |
412 | * Pointer to the idmap entry for the container's root gid in | |
413 | * the id_map list. Do not free! | |
414 | */ | |
5173b710 | 415 | const struct id_map *root_nsgid_map; |
46ad64ab | 416 | }; |
edd64e17 | 417 | |
87d0990c | 418 | struct list_head netdevs; |
448d7b0c CB |
419 | |
420 | struct { | |
421 | char *fstab; | |
422 | int auto_mounts; | |
be0bc4d1 | 423 | struct list_head mount_entries; |
448d7b0c CB |
424 | }; |
425 | ||
20ab7578 | 426 | struct caps caps; |
885766f5 | 427 | |
a2db71c0 | 428 | /* /dev/tty<idx> devices */ |
885766f5 | 429 | struct lxc_tty_info ttys; |
a2db71c0 CB |
430 | /* /dev/console device */ |
431 | struct lxc_terminal console; | |
432 | /* maximum pty devices allowed by devpts mount */ | |
e528c735 | 433 | size_t pty_max; |
f797f05e CB |
434 | /* file descriptor for the container's /dev/pts mount */ |
435 | int devpts_fd; | |
885766f5 | 436 | |
32fd6cf3 CB |
437 | /* set to true when rootfs has been setup */ |
438 | bool rootfs_setup; | |
33fcb7a0 | 439 | struct lxc_rootfs rootfs; |
32fd6cf3 | 440 | |
b3187a81 | 441 | bool close_all_fds; |
44ae0fb6 CB |
442 | |
443 | struct { | |
444 | unsigned int hooks_version; | |
5090de3e | 445 | struct list_head hooks[NUM_LXC_HOOKS]; |
44ae0fb6 | 446 | }; |
4a85ce2a | 447 | |
fe4de9a6 | 448 | char *lsm_aa_profile; |
1800f924 WB |
449 | char *lsm_aa_profile_computed; |
450 | bool lsm_aa_profile_created; | |
451 | unsigned int lsm_aa_allow_nesting; | |
a56e2df9 | 452 | unsigned int lsm_aa_allow_incomplete; |
1fb1e667 | 453 | struct list_head lsm_aa_raw; |
fe4de9a6 | 454 | char *lsm_se_context; |
4fef78bc | 455 | char *lsm_se_keyring_context; |
8f818a84 | 456 | bool keyring_disable_session; |
952b5031 | 457 | bool transient_procfs_mnt; |
c3e3c21a | 458 | struct lxc_seccomp seccomp; |
72d0e1cb | 459 | int maincmd_fd; |
1a0e70ac | 460 | unsigned int autodev; /* if 1, mount and fill a /dev at start */ |
63012bdd | 461 | int autodevtmpfssize; /* size of the /dev tmpfs */ |
1a0e70ac CB |
462 | int haltsignal; /* signal used to halt container */ |
463 | int rebootsignal; /* signal used to reboot container */ | |
464 | int stopsignal; /* signal used to hard stop container */ | |
465 | char *rcfile; /* Copy of the top level rcfile we read */ | |
466 | ||
b9949538 | 467 | /* Logfile and loglevel can be set in a container config file. Those |
7b660465 | 468 | * function as defaults. The defaults can be overridden by command line. |
1a0e70ac CB |
469 | * However we don't want the command line specified values to be saved |
470 | * on c->save_config(). So we store the config file specified values | |
471 | * here. */ | |
98020c31 JS |
472 | char *logfile; /* the logfile as specified in config */ |
473 | int loglevel; /* loglevel as specified in config (if any) */ | |
858377e4 | 474 | int logfd; |
9f30a190 | 475 | |
3590152f CB |
476 | unsigned int start_auto; |
477 | unsigned int start_delay; | |
ee1e7aa0 | 478 | int start_order; |
ffb2a35f | 479 | struct list_head groups; |
76a26f55 | 480 | int nbd_idx; |
35120d9c | 481 | |
a8dfe4e0 | 482 | /* unshare the mount namespace in the monitor */ |
226dc30e | 483 | unsigned int monitor_unshare; |
258f8051 | 484 | unsigned int monitor_signal_pdeath; |
a8dfe4e0 | 485 | |
7c661726 MP |
486 | /* list of environment variables we'll add to the container when |
487 | * started */ | |
c294a68d | 488 | struct list_head environment; |
6b0d5538 SH |
489 | |
490 | /* text representation of the config file */ | |
491 | char *unexpanded_config; | |
32fd6cf3 CB |
492 | size_t unexpanded_len; |
493 | size_t unexpanded_alloced; | |
67c660d0 | 494 | |
5cda27c1 SH |
495 | /* default command for lxc-execute */ |
496 | char *execute_cmd; | |
497 | ||
67c660d0 SG |
498 | /* init command */ |
499 | char *init_cmd; | |
56f8ff00 | 500 | |
4822319f | 501 | /* The uid to use for the container. */ |
c5cd20ce | 502 | uid_t init_uid; |
4822319f | 503 | /* The gid to use for the container. */ |
c5cd20ce | 504 | gid_t init_gid; |
4822319f CB |
505 | /* The groups to use for the container. */ |
506 | lxc_groups_t init_groups; | |
8796becf CB |
507 | |
508 | /* indicator if the container will be destroyed on shutdown */ | |
66ffdb1a | 509 | unsigned int ephemeral; |
76d0127f CB |
510 | |
511 | /* The facility to pass to syslog. Let's users establish as what type of | |
512 | * program liblxc is supposed to write to the syslog. */ | |
513 | char *syslog; | |
5a46f283 CB |
514 | |
515 | /* Whether PR_SET_NO_NEW_PRIVS will be set for the container. */ | |
516 | bool no_new_privs; | |
c6d09e15 WB |
517 | |
518 | /* RLIMIT_* limits */ | |
223797c3 | 519 | struct list_head limits; |
7ec2e32a | 520 | |
43654d34 CB |
521 | /* Contains generic info about the cgroup configuration for this |
522 | * container. Note that struct lxc_cgroup contains a union. It is only | |
523 | * valid to access the members of the anonymous "meta" struct within | |
524 | * that union. | |
525 | */ | |
526 | struct lxc_cgroup cgroup_meta; | |
28d9e29e | 527 | |
b074bbf1 | 528 | struct { |
1d8d3676 | 529 | int ns_clone; |
abeb5bba | 530 | int ns_keep; |
b074bbf1 CB |
531 | char *ns_share[LXC_NS_MAX]; |
532 | }; | |
3c491553 L |
533 | |
534 | /* init working directory */ | |
9e132956 | 535 | char *init_cwd; |
3c491553 | 536 | |
d39b10eb | 537 | /* A list of clients registered to be informed about a container state. */ |
d2e75eba | 538 | struct list_head state_clients; |
7edd0540 L |
539 | |
540 | /* sysctls */ | |
ba9f9347 | 541 | struct list_head sysctls; |
61d7a733 YT |
542 | |
543 | /* procs */ | |
91d04bf9 | 544 | struct list_head procs; |
adf0ba1f | 545 | |
7a41e857 | 546 | struct shmount { |
adf0ba1f LT |
547 | /* Absolute path to the shared mount point on the host */ |
548 | char *path_host; | |
549 | /* Absolute path (in the container) to the shared mount point */ | |
550 | char *path_cont; | |
7a41e857 | 551 | } shmount; |
70fd7fc9 CB |
552 | |
553 | struct timens_offsets timens; | |
09996a48 CB |
554 | |
555 | bool sched_core; | |
556 | __u64 sched_core_cookie; | |
571e6ec8 DL |
557 | }; |
558 | ||
efb7e304 CB |
559 | __hidden extern int write_id_mapping(enum idtype idtype, pid_t pid, const char *buf, size_t buf_size) |
560 | __access_r(3, 4); | |
344c9d81 | 561 | |
d7f19646 | 562 | extern thread_local struct lxc_conf *current_config; |
858377e4 | 563 | |
efb7e304 CB |
564 | __hidden extern int run_lxc_hooks(const char *name, char *hook, struct lxc_conf *conf, char *argv[]); |
565 | __hidden extern struct lxc_conf *lxc_conf_init(void); | |
566 | __hidden extern void lxc_conf_free(struct lxc_conf *conf); | |
4e86cad3 CB |
567 | __hidden extern int lxc_storage_prepare(struct lxc_conf *conf); |
568 | __hidden extern int lxc_rootfs_prepare(struct lxc_conf *conf, bool userns); | |
569 | __hidden extern void lxc_storage_put(struct lxc_conf *conf); | |
239f29c9 | 570 | __hidden extern int lxc_rootfs_init(struct lxc_conf *conf, bool userns); |
4b875ef9 | 571 | __hidden extern int lxc_rootfs_prepare_parent(struct lxc_handler *handler); |
1b82d721 | 572 | __hidden extern int lxc_idmapped_mounts_parent(struct lxc_handler *handler); |
0589d744 | 573 | __hidden extern int lxc_map_ids(struct list_head *idmap, pid_t pid); |
efb7e304 CB |
574 | __hidden extern int lxc_create_tty(const char *name, struct lxc_conf *conf); |
575 | __hidden extern void lxc_delete_tty(struct lxc_tty_info *ttys); | |
576 | __hidden extern int lxc_clear_config_caps(struct lxc_conf *c); | |
efb7e304 CB |
577 | __hidden extern int lxc_clear_cgroups(struct lxc_conf *c, const char *key, int version); |
578 | __hidden extern int lxc_clear_mount_entries(struct lxc_conf *c); | |
579 | __hidden extern int lxc_clear_automounts(struct lxc_conf *c); | |
580 | __hidden extern int lxc_clear_hooks(struct lxc_conf *c, const char *key); | |
581 | __hidden extern int lxc_clear_idmaps(struct lxc_conf *c); | |
582 | __hidden extern int lxc_clear_groups(struct lxc_conf *c); | |
583 | __hidden extern int lxc_clear_environment(struct lxc_conf *c); | |
584 | __hidden extern int lxc_clear_limits(struct lxc_conf *c, const char *key); | |
585 | __hidden extern int lxc_delete_autodev(struct lxc_handler *handler); | |
586 | __hidden extern int lxc_clear_autodev_tmpfs_size(struct lxc_conf *c); | |
efb7e304 CB |
587 | __hidden extern int lxc_setup_rootfs_prepare_root(struct lxc_conf *conf, const char *name, |
588 | const char *lxcpath); | |
589 | __hidden extern int lxc_setup(struct lxc_handler *handler); | |
590 | __hidden extern int lxc_setup_parent(struct lxc_handler *handler); | |
223797c3 | 591 | __hidden extern int setup_resource_limits(struct lxc_conf *conf, pid_t pid); |
efb7e304 CB |
592 | __hidden extern int find_unmapped_nsid(const struct lxc_conf *conf, enum idtype idtype); |
593 | __hidden extern int mapped_hostid(unsigned id, const struct lxc_conf *conf, enum idtype idtype); | |
594 | __hidden extern int userns_exec_1(const struct lxc_conf *conf, int (*fn)(void *), void *data, | |
595 | const char *fn_name); | |
596 | __hidden extern int userns_exec_full(struct lxc_conf *conf, int (*fn)(void *), void *data, | |
597 | const char *fn_name); | |
d94eb390 | 598 | __hidden extern int parse_mntopts_legacy(const char *mntopts, unsigned long *mntflags, char **mntdata); |
efb7e304 | 599 | __hidden extern int parse_propagationopts(const char *mntopts, unsigned long *pflags); |
1b82d721 | 600 | __hidden extern int parse_lxc_mount_attrs(struct lxc_mount_options *opts, char *mnt_opts); |
704cadd5 | 601 | __hidden extern int parse_mount_attrs(struct lxc_mount_options *opts, const char *mntopts); |
efb7e304 | 602 | __hidden extern void tmp_proc_unmount(struct lxc_conf *lxc_conf); |
efb7e304 | 603 | __hidden extern void suggest_default_idmap(void); |
be0bc4d1 CB |
604 | __hidden extern FILE *make_anonymous_mount_file(const struct list_head *mount, |
605 | bool include_nesting_helpers); | |
efb7e304 CB |
606 | __hidden extern int run_script(const char *name, const char *section, const char *script, ...); |
607 | __hidden extern int run_script_argv(const char *name, unsigned int hook_version, const char *section, | |
608 | const char *script, const char *hookname, char **argsin); | |
309ae287 | 609 | |
7418b27f CB |
610 | __hidden extern bool has_cap(__u32 cap, struct lxc_conf *conf); |
611 | static inline bool lxc_wants_cap(__u32 cap, struct lxc_conf *conf) | |
309ae287 | 612 | { |
7418b27f CB |
613 | __u32 last_cap; |
614 | int ret; | |
615 | ||
616 | ret = lxc_caps_last_cap(&last_cap); | |
617 | if (ret) | |
618 | return false; | |
619 | ||
620 | if (last_cap < cap) | |
d84b26bc CB |
621 | return false; |
622 | ||
20ab7578 | 623 | return has_cap(cap, conf); |
309ae287 CB |
624 | } |
625 | ||
ba9f9347 | 626 | __hidden extern int setup_sysctl_parameters(struct lxc_conf *conf); |
efb7e304 | 627 | __hidden extern int lxc_clear_sysctls(struct lxc_conf *c, const char *key); |
91d04bf9 | 628 | __hidden extern int setup_proc_filesystem(struct lxc_conf *conf, pid_t pid); |
efb7e304 CB |
629 | __hidden extern int lxc_clear_procs(struct lxc_conf *c, const char *key); |
630 | __hidden extern int lxc_clear_apparmor_raw(struct lxc_conf *c); | |
631 | __hidden extern int lxc_clear_namespace(struct lxc_conf *c); | |
632 | __hidden extern int userns_exec_minimal(const struct lxc_conf *conf, int (*fn_parent)(void *), | |
633 | void *fn_parent_data, int (*fn_child)(void *), | |
634 | void *fn_child_data); | |
635 | __hidden extern int userns_exec_mapped_root(const char *path, int path_fd, | |
636 | const struct lxc_conf *conf); | |
6e1a327a CB |
637 | static inline int chown_mapped_root(const char *path, const struct lxc_conf *conf) |
638 | { | |
639 | return userns_exec_mapped_root(path, -EBADF, conf); | |
640 | } | |
5ae72b98 | 641 | |
493ae3fe | 642 | __hidden extern int lxc_sync_fds_parent(struct lxc_handler *handler); |
111ed96e | 643 | __hidden extern int lxc_sync_fds_child(struct lxc_handler *handler); |
68f3899e | 644 | |
02efd041 CB |
645 | static inline const char *get_rootfs_mnt(const struct lxc_rootfs *rootfs) |
646 | { | |
647 | static const char *s = "/"; | |
648 | ||
649 | return !is_empty_string(rootfs->path) ? rootfs->mount : s; | |
650 | } | |
651 | ||
423374e9 CB |
652 | static inline void put_lxc_mount_options(struct lxc_mount_options *mnt_opts) |
653 | { | |
654 | mnt_opts->create_dir = 0; | |
655 | mnt_opts->create_file = 0; | |
656 | mnt_opts->optional = 0; | |
657 | mnt_opts->relative = 0; | |
658 | mnt_opts->userns_path[0] = '\0'; | |
659 | mnt_opts->mnt_flags = 0; | |
660 | mnt_opts->prop_flags = 0; | |
661 | ||
423374e9 | 662 | free_disarm(mnt_opts->data); |
e73af35b | 663 | free_disarm(mnt_opts->raw_options); |
423374e9 CB |
664 | } |
665 | ||
79ff643d CB |
666 | static inline void put_lxc_rootfs(struct lxc_rootfs *rootfs, bool unpin) |
667 | { | |
668 | if (rootfs) { | |
669 | close_prot_errno_disarm(rootfs->dfd_host); | |
670 | close_prot_errno_disarm(rootfs->dfd_mnt); | |
671 | close_prot_errno_disarm(rootfs->dfd_dev); | |
672 | if (unpin) | |
673 | close_prot_errno_disarm(rootfs->fd_path_pin); | |
4b875ef9 | 674 | close_prot_errno_disarm(rootfs->dfd_idmapped); |
423374e9 | 675 | put_lxc_mount_options(&rootfs->mnt_opts); |
4e86cad3 CB |
676 | storage_put(rootfs->storage); |
677 | rootfs->storage = NULL; | |
79ff643d CB |
678 | } |
679 | } | |
680 | ||
a7744f12 CB |
681 | static inline void lxc_clear_cgroup2_devices(struct bpf_devices *bpf_devices) |
682 | { | |
93de768e | 683 | struct device_item *device, *n; |
a7744f12 | 684 | |
93de768e CB |
685 | list_for_each_entry_safe(device, n, &bpf_devices->devices, head) |
686 | list_del(&device->head); | |
a7744f12 | 687 | |
93de768e | 688 | INIT_LIST_HEAD(&bpf_devices->devices); |
a7744f12 CB |
689 | } |
690 | ||
64a04c84 CB |
691 | static inline int lxc_personality(personality_t persona) |
692 | { | |
693 | if (persona < 0) | |
694 | return ret_errno(EINVAL); | |
695 | ||
696 | return personality(persona); | |
697 | } | |
698 | ||
c294a68d | 699 | __hidden extern int lxc_set_environment(const struct lxc_conf *conf); |
7418b27f | 700 | __hidden extern int parse_cap(const char *cap_name, __u32 *cap); |
c294a68d | 701 | |
1a0e70ac | 702 | #endif /* __LXC_CONF_H */ |