summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorDaan De Meyer <daan.j.demeyer@gmail.com>2024-08-14 12:43:05 +0200
committerMike Yuan <me@yhndnzj.com>2024-08-16 10:11:29 +0200
commit2701c2f67de592fe2565b084cfaec1667767dbaf (patch)
treea3b63bc8394abcdffdb5b2d36f83a83883376617 /docs
parenttest: fix typo (diff)
downloadsystemd-2701c2f67de592fe2565b084cfaec1667767dbaf.tar.xz
systemd-2701c2f67de592fe2565b084cfaec1667767dbaf.zip
Add $SYSTEMD_IN_CHROOT to override chroot detection
When running unprivileged, checking /proc/1/root doesn't work because it requires privileges. Instead, let's add an environment variable so the process that chroot's can tell (systemd) subprocesses whether they're running in a chroot or not.
Diffstat (limited to 'docs')
-rw-r--r--docs/ENVIRONMENT.md14
1 files changed, 7 insertions, 7 deletions
diff --git a/docs/ENVIRONMENT.md b/docs/ENVIRONMENT.md
index 5848c0fd80..c416370440 100644
--- a/docs/ENVIRONMENT.md
+++ b/docs/ENVIRONMENT.md
@@ -23,17 +23,17 @@ All tools:
* `$SYSTEMD_OFFLINE=[0|1]` — if set to `1`, then `systemctl` will refrain from
talking to PID 1; this has the same effect as the historical detection of
`chroot()`. Setting this variable to `0` instead has a similar effect as
- `$SYSTEMD_IGNORE_CHROOT=1`; i.e. tools will try to communicate with PID 1
+ `$SYSTEMD_IN_CHROOT=0`; i.e. tools will try to communicate with PID 1
even if a `chroot()` environment is detected. You almost certainly want to
set this to `1` if you maintain a package build system or similar and are
trying to use a modern container system and not plain `chroot()`.
-* `$SYSTEMD_IGNORE_CHROOT=1` — if set, don't check whether being invoked in a
- `chroot()` environment. This is particularly relevant for systemctl, as it
- will not alter its behaviour for `chroot()` environments if set. Normally it
- refrains from talking to PID 1 in such a case; turning most operations such
- as `start` into no-ops. If that's what's explicitly desired, you might
- consider setting `$SYSTEMD_OFFLINE=1`.
+* `$SYSTEMD_IN_CHROOT=0|1` — takes a boolean. If set, overrides chroot detection.
+ This is particularly relevant for systemctl, as it will not alter its behaviour
+ for `chroot()` environments if `SYSTEMD_IN_CHROOT=0`. Normally it refrains from
+ talking to PID 1 in such a case; turning most operations such as `start` into
+ no-ops. If that's what's explicitly desired, you might consider setting
+ `$SYSTEMD_OFFLINE=1`.
* `$SYSTEMD_FIRST_BOOT=0|1` — if set, assume "first boot" condition to be false
or true, instead of checking the flag file created by PID 1.