2012-07-18 19:07:51 +02:00
|
|
|
#pragma once
|
2010-04-21 22:15:06 +02:00
|
|
|
|
|
|
|
|
/***
|
|
|
|
|
This file is part of systemd.
|
|
|
|
|
|
|
|
|
|
Copyright 2010 Lennart Poettering
|
2016-10-12 14:11:16 +02:00
|
|
|
Copyright 2016 Djalal Harouni
|
2010-04-21 22:15:06 +02:00
|
|
|
|
|
|
|
|
systemd is free software; you can redistribute it and/or modify it
|
2012-04-12 00:20:58 +02:00
|
|
|
under the terms of the GNU Lesser General Public License as published by
|
|
|
|
|
the Free Software Foundation; either version 2.1 of the License, or
|
2010-04-21 22:15:06 +02:00
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
|
|
systemd is distributed in the hope that it will be useful, but
|
|
|
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
2012-04-12 00:20:58 +02:00
|
|
|
Lesser General Public License for more details.
|
2010-04-21 22:15:06 +02:00
|
|
|
|
2012-04-12 00:20:58 +02:00
|
|
|
You should have received a copy of the GNU Lesser General Public License
|
2010-04-21 22:15:06 +02:00
|
|
|
along with systemd; If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
***/
|
|
|
|
|
|
2016-10-12 14:11:16 +02:00
|
|
|
typedef struct NameSpaceInfo NameSpaceInfo;
|
2016-11-23 22:21:40 +01:00
|
|
|
typedef struct BindMount BindMount;
|
2016-10-12 14:11:16 +02:00
|
|
|
|
2010-04-21 22:15:06 +02:00
|
|
|
#include <stdbool.h>
|
|
|
|
|
|
2016-12-23 14:26:05 +01:00
|
|
|
#include "dissect-image.h"
|
2014-06-03 23:41:44 +02:00
|
|
|
#include "macro.h"
|
|
|
|
|
|
2014-06-04 18:07:55 +02:00
|
|
|
typedef enum ProtectHome {
|
|
|
|
|
PROTECT_HOME_NO,
|
|
|
|
|
PROTECT_HOME_YES,
|
|
|
|
|
PROTECT_HOME_READ_ONLY,
|
|
|
|
|
_PROTECT_HOME_MAX,
|
|
|
|
|
_PROTECT_HOME_INVALID = -1
|
|
|
|
|
} ProtectHome;
|
|
|
|
|
|
|
|
|
|
typedef enum ProtectSystem {
|
|
|
|
|
PROTECT_SYSTEM_NO,
|
|
|
|
|
PROTECT_SYSTEM_YES,
|
|
|
|
|
PROTECT_SYSTEM_FULL,
|
2016-08-25 15:57:21 +02:00
|
|
|
PROTECT_SYSTEM_STRICT,
|
2014-06-04 18:07:55 +02:00
|
|
|
_PROTECT_SYSTEM_MAX,
|
|
|
|
|
_PROTECT_SYSTEM_INVALID = -1
|
|
|
|
|
} ProtectSystem;
|
2014-06-03 23:41:44 +02:00
|
|
|
|
2016-10-12 14:11:16 +02:00
|
|
|
struct NameSpaceInfo {
|
2016-11-06 23:31:55 +01:00
|
|
|
bool ignore_protect_paths:1;
|
2016-10-12 14:11:16 +02:00
|
|
|
bool private_dev:1;
|
|
|
|
|
bool protect_control_groups:1;
|
|
|
|
|
bool protect_kernel_tunables:1;
|
|
|
|
|
bool protect_kernel_modules:1;
|
2016-12-22 23:34:35 +01:00
|
|
|
bool mount_apivfs:1;
|
2016-10-12 14:11:16 +02:00
|
|
|
};
|
|
|
|
|
|
2016-11-23 22:21:40 +01:00
|
|
|
struct BindMount {
|
|
|
|
|
char *source;
|
|
|
|
|
char *destination;
|
|
|
|
|
bool read_only:1;
|
|
|
|
|
bool recursive:1;
|
|
|
|
|
bool ignore_enoent:1;
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
int setup_namespace(
|
|
|
|
|
const char *root_directory,
|
2016-12-23 14:26:05 +01:00
|
|
|
const char *root_image,
|
2016-11-23 22:21:40 +01:00
|
|
|
const NameSpaceInfo *ns_info,
|
|
|
|
|
char **read_write_paths,
|
|
|
|
|
char **read_only_paths,
|
|
|
|
|
char **inaccessible_paths,
|
execute: make StateDirectory= and friends compatible with DynamicUser=1 and RootDirectory=/RootImage=
Let's clean up the interaction of StateDirectory= (and friends) to
DynamicUser=1: instead of creating these directories directly below
/var/lib, place them in /var/lib/private instead if DynamicUser=1 is
set, making that directory 0700 and owned by root:root. This way, if a
dynamic UID is later reused, access to the old run's state directory is
prohibited for that user. Then, use file system namespacing inside the
service to make /var/lib/private a readable tmpfs, hiding all state
directories that are not listed in StateDirectory=, and making access to
the actual state directory possible. Mount all directories listed in
StateDirectory= to the same places inside the service (which means
they'll now be mounted into the tmpfs instance). Finally, add a symlink
from the state directory name in /var/lib/ to the one in
/var/lib/private, so that both the host and the service can access the
path under the same location.
Here's an example: let's say a service runs with StateDirectory=foo.
When DynamicUser=0 is set, it will get the following setup, and no
difference between what the unit and what the host sees:
/var/lib/foo (created as directory)
Now, if DynamicUser=1 is set, we'll instead get this on the host:
/var/lib/private (created as directory with mode 0700, root:root)
/var/lib/private/foo (created as directory)
/var/lib/foo → private/foo (created as symlink)
And from inside the unit:
/var/lib/private (a tmpfs mount with mode 0755, root:root)
/var/lib/private/foo (bind mounted from the host)
/var/lib/foo → private/foo (the same symlink as above)
This takes inspiration from how container trees are protected below
/var/lib/machines: they generally reuse UIDs/GIDs of the host, but
because /var/lib/machines itself is set to 0700 host users cannot access
files in the container tree even if the UIDs/GIDs are reused. However,
for this commit we add one further trick: inside and outside of the unit
/var/lib/private is a different thing: outside it is a plain,
inaccessible directory, and inside it is a world-readable tmpfs mount
with only the whitelisted subdirs below it, bind mounte din. This
means, from the outside the dir acts as an access barrier, but from the
inside it does not. And the symlink created in /var/lib/foo itself
points across the barrier in both cases, so that root and the unit's
user always have access to these dirs without knowing the details of
this mounting magic.
This logic resolves a major shortcoming of DynamicUser=1 units:
previously they couldn't safely store persistant data. With this change
they can have their own private state, log and data directories, which
they can write to, but which are protected from UID recycling.
With this change, if RootDirectory= or RootImage= are used it is ensured
that the specified state/log/cache directories are always mounted in
from the host. This change of semantics I think is much preferable since
this means the root directory/image logic can be used easily for
read-only resource bundling (as all writable data resides outside of the
image). Note that this is a change of behaviour, but given that we
haven't released any systemd version with StateDirectory= and friends
implemented this should be a safe change to make (in particular as
previously it wasn't clear what would actually happen when used in
combination). Moreover, by making this change we can later add a "+"
modifier to these setings too working similar to the same modifier in
ReadOnlyPaths= and friends, making specified paths relative to the
container itself.
2017-09-28 18:55:45 +02:00
|
|
|
char **empty_directories,
|
2016-11-23 22:21:40 +01:00
|
|
|
const BindMount *bind_mounts,
|
|
|
|
|
unsigned n_bind_mounts,
|
|
|
|
|
const char *tmp_dir,
|
|
|
|
|
const char *var_tmp_dir,
|
|
|
|
|
ProtectHome protect_home,
|
|
|
|
|
ProtectSystem protect_system,
|
2016-12-23 14:26:05 +01:00
|
|
|
unsigned long mount_flags,
|
|
|
|
|
DissectImageFlags dissected_image_flags);
|
2016-11-23 22:21:40 +01:00
|
|
|
|
|
|
|
|
int setup_tmp_dirs(
|
|
|
|
|
const char *id,
|
|
|
|
|
char **tmp_dir,
|
|
|
|
|
char **var_tmp_dir);
|
2013-11-27 20:23:18 +01:00
|
|
|
|
|
|
|
|
int setup_netns(int netns_storage_socket[2]);
|
2014-06-03 23:41:44 +02:00
|
|
|
|
2014-06-04 18:07:55 +02:00
|
|
|
const char* protect_home_to_string(ProtectHome p) _const_;
|
|
|
|
|
ProtectHome protect_home_from_string(const char *s) _pure_;
|
|
|
|
|
|
|
|
|
|
const char* protect_system_to_string(ProtectSystem p) _const_;
|
|
|
|
|
ProtectSystem protect_system_from_string(const char *s) _pure_;
|
2016-11-23 22:21:40 +01:00
|
|
|
|
|
|
|
|
void bind_mount_free_many(BindMount *b, unsigned n);
|
|
|
|
|
int bind_mount_add(BindMount **b, unsigned *n, const BindMount *item);
|