Skip to content

Commit 5e2ce88

Browse files
committed
docs: Describe / as a composefs mount in bootc-sysroot(7)
The text predates composefs and still says / is a bind mount of the deployment directory. With composefs enabled, which the docs recommend and the composefs backend always uses, / is a composefs mount instead, and its mount source is no longer the root block device. That matters for tools that look at / to find the disk. Assisted-by: AI Signed-off-by: Joseph Marrero Corchado <jmarrero@redhat.com>
1 parent 0ca885f commit 5e2ce88

1 file changed

Lines changed: 7 additions & 5 deletions

File tree

‎docs/src/bootc-sysroot.7.md‎

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,13 @@ In the future, this functionality will be exposed and used by `bootc`.
1919
## /sysroot mount
2020

2121
When booted, the physical root will be available at `/sysroot` as a
22-
read-only mount point and the logical root `/` will be a bind mount
23-
pointing to a deployment directory under `/sysroot/ostree`. This is a
24-
key aspect of how `bootc upgrade` operates: it fetches the updated
25-
container image and writes the base image files (using OSTree storage
26-
to `/sysroot/ostree/repo`).
22+
read-only mount point. With composefs enabled (as recommended in
23+
[filesystem](bootc-filesystem.7.md), and always with the composefs
24+
backend), the logical root `/` is a read-only composefs mount of the
25+
deployed image; otherwise it is a bind mount of a deployment directory
26+
under `/sysroot/ostree`. This is a key aspect of how `bootc upgrade`
27+
operates: it fetches the updated container image and writes the base
28+
image files (using OSTree storage to `/sysroot/ostree/repo`).
2729

2830
Beyond that and debugging/introspection, there are few use cases for tooling to
2931
operate on the physical root.

0 commit comments

Comments
 (0)