Skip to content

rauc: prepare for hermetic /usr/#427

Draft
ejoerns wants to merge 12 commits intorauc:masterfrom
ejoerns:hermetic-usr
Draft

rauc: prepare for hermetic /usr/#427
ejoerns wants to merge 12 commits intorauc:masterfrom
ejoerns:hermetic-usr

Conversation

@ejoerns
Copy link
Copy Markdown
Member

@ejoerns ejoerns commented Apr 8, 2026

The /etc directory is meant for 'local administrator' usage, which a distro build by OE isn't. For the same reason, several OE upstream packages (including systemd itself) already switch to installing into /usr instead of /etc.
For details on the concept, see [1].

RAUC supports reading the system.conf from /usr/ since v1.13 [2].

For the next Yocto LTS release, we adapt to the new installation location, which might require migration for existing integrations. However, for most cases, no manual change should be required.

Add a note to the migration chapter to make users ware of this.

[1] https://0pointer.net/blog/fitting-everything-together.html
[2] rauc/rauc#1557

Partly based on 4cb7c47 ("rauc: prepare support for locating the config in /usr or /run").

Based on #426

Fixes #389

ejoerns added 12 commits April 8, 2026 12:55
This should be shown as 'code', not as 'italic'.

Signed-off-by: Enrico Jörns <ejo@pengutronix.de>
Signed-off-by: Enrico Jörns <ejo@pengutronix.de>
This plural form originates from when the section described
rauc-hawkbit, too.

Fixes: 1a9a22d ("rauc-hawkbit: remove recipe and references")

Signed-off-by: Enrico Jörns <ejo@pengutronix.de>
This is basic Yocto/OE knowledge that is not worth being replicated in
each individual layer.

While at it, drop the section numbers, since we don't intend to write a
whole book here.

Signed-off-by: Enrico Jörns <ejo@pengutronix.de>
Better outline the purpose of RAUC and this layer.
Add note on host and target side integration.

Signed-off-by: Enrico Jörns <ejo@pengutronix.de>
* Shorten the description
* drop 'bitbake', which of course is required, but not a layer.
* clarify the casync requirements and scope

Signed-off-by: Enrico Jörns <ejo@pengutronix.de>
* 'changes' is too broad, we don't intend to backport all new features
* allow 'backport' in backport notes, too (e.g. when not doing a pure
  cherry pick
* replace 'poky releases' by 'Yocto releases'

Signed-off-by: Enrico Jörns <ejo@pengutronix.de>
This mainly replicates the information from the "Contributing" chapter.
Move the Maintainers note there.

Signed-off-by: Enrico Jörns <ejo@pengutronix.de>
It's not sufficient to just set FILESEXTRAPATHS, you'd also need the
system.conf file itself. Also the keyring is installed this way for most
use cases.

Reword 'RAUC update file' to 'RAUC system configuration' which is more
appropriate.

Signed-off-by: Enrico Jörns <ejo@pengutronix.de>
Recent bundles should not be build without, if possible.

Signed-off-by: Enrico Jörns <ejo@pengutronix.de>
Signed-off-by: Enrico Jörns <ejo@pengutronix.de>
The /etc directory is meant for 'local administrator' usage, which a
distro build by OE isn't. For the same reason, several OE upstream
packages (including systemd itself) already switch to installing into
/usr instead of /etc.
For details on the concept, see [1].

RAUC supports reading the system.conf from /usr/ since v1.13 [2].

For the next Yocto LTS release, we adapt to the new installation
location, which might require migration for existing integrations.
However, for most cases, no manual change should be required.

Add a note to the migration chapter to make users ware of this.

[1] https://0pointer.net/blog/fitting-everything-together.html
[2] rauc/rauc#1557

Partly based on 4cb7c47 ("rauc: prepare support for locating the config
in /usr or /run").

Signed-off-by: Enrico Jörns <ejo@pengutronix.de>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Adapt master/scarthgap for hermetic-usr support

1 participant