Skip to content

Commit 19616ef

Browse files
authored
Merge pull request #1363 from cgwalters/kargs-w-rpmostree
kargs: Clarify a bit more
2 parents 19a8527 + e0b1769 commit 19616ef

File tree

1 file changed

+21
-2
lines changed

1 file changed

+21
-2
lines changed

docs/src/building/kernel-arguments.md

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -68,12 +68,31 @@ the `/boot/loader/entries` files, which are in a standardized
6868
format.
6969

7070
Typically, `/boot` is mounted read-only to limit
71-
the set of tools which write to this filesystem.
71+
the set of tools which write to this filesystem. It is not
72+
"physically" read-only by default. One approach to edit
73+
them is to run a tool under a new mount namespace, e.g.
74+
75+
```bash
76+
unshare -m
77+
mount -o remount,rw /boot
78+
# tool to edit /boot/loader/entries
79+
```
7280

7381
At the current time, `bootc` does not itself offer
7482
an API to manipulate kernel arguments maintained per-machine.
7583

76-
Other projects such as `rpm-ostree` do, via e.g. `rpm-ostree kargs`.
84+
Other projects such as `rpm-ostree` do, via e.g. `rpm-ostree kargs`,
85+
which is just a frontend for editing the bootloader configuration
86+
files. Note an important detail is that `rpm-ostree kargs` always
87+
creates a new deployment.
88+
89+
`rpm-ostree kargs` and bootc will interoperate as they both
90+
use the ostree backend today, and any kernel arguments changed
91+
via that mechanism will persist across upgrades.
92+
93+
It is currently undefined behavior to remove kernel arguments
94+
locally that are included in the base image via
95+
`/usr/lib/bootc/kargs.d`.
7796

7897
## Injecting default arguments into custom kernels
7998

0 commit comments

Comments
 (0)