feat: rename rd.live.overlay to rd.overlay

The overlay functionality can be used with both dmsquash-live and
overlayfs modules, and is not limited to live images. This change
improves naming of command line options with better namespace scoping.

Renames:
- rd.live.overlay -> rd.overlay
- rd.live.overlay.reset -> rd.overlay.reset

Backward compatibility is maintained through deprecation flags.

fix(test/DMSQUASH): zero overlay partition on reset

The reset_overlay_partition function was not fully clearing
the overlay partition. Delete the partition from the
partition table and zero out the disk region to ensure a
clean state between test runs.

refactor(test/DMSQUASH): extract autooverlay helpers for reuse

Extract check_autooverlay_marker() and reset_overlay_partition() helper
functions to avoid code duplication when testing multiple autooverlay
scenarios.

docs(systemd-pcrphase): mention the new binary name

Clarify the comment which of the two names is the new one.

fix(dmsquash-live-autooverlay): re-read partition table after creation

After parted creates the overlay partition, the kernel's in-memory
partition table is not automatically updated. This causes mkfs to fail
with "The file /dev/sdX does not exist" on some systems.

Add blockdev --rereadpt to force the kernel to re-read the partition
table before attempting to create the filesystem.

fix(systemd-pcrphase): do not print an error if an optional binary is not found

Fixes #2094

feat(lvm): match host lvm recovery installation

These LVM tools are just symlinks to binaries that are already installed
inside the initramfs. Dracut might as well install these symlinks to
avoid people looking for them during a potentially stressful recovery time.

ci: create common multi-arch container tag

The same container tag can be used for images with different
architectures. That is the case for most common images (like
`ubuntu:devel`).

fix(Makefile): broken symlink in dracut config examples

Due to commit [1], it installs dracut config examples under /usr.
But while enable_test=no, the symlink of test in dracut config is broken
```
root@qemux86-64:~# ls /usr/lib/dracut/dracut.conf.d/test*  -ahl
lrwxrwxrwx 1 root root 27 Apr  5  2011 /usr/lib/dracut/dracut.conf.d/test -> ../test/dracut.conf.d/test/
lrwxrwxrwx 1 root root 36 Apr  5  2011 /usr/lib/dracut/dracut.conf.d/test-makeroot -> ../test/dracut.conf.d/test-makeroot/
lrwxrwxrwx 1 root root 31 Apr  5  2011 /usr/lib/dracut/dracut.conf.d/test-root -> ../test/dracut.conf.d/test-root
root@qemux86-64:~# realpath /usr/lib/dracut/dracut.conf.d/test*
realpath: /usr/lib/dracut/dracut.conf.d/test: No such file or directory
realpath: /usr/lib/dracut/dracut.conf.d/test-makeroot: No such file or directory
realpath: /usr/lib/dracut/dracut.conf.d/test-root: No such file or directory
```

This commit cleans up test symlink if enable_test=no

[1] https://github.com/dracut-ng/dracut-ng/commit/0d369e3e30935dffe48dfff1e90463868e7f804a

Signed-off-by: Hongxu Jia <hongxu.jia@windriver.com>

feat(livenet): support root=http:* as alias for root=live:http:*

For compatibility with `cloud-initramfs-rooturl` support `root=http:*`
as alias for `root=live:http:*` and `root=https:*` as alias for
`root=live:https:*`.

feat: move DRACUT_VERSION from dracut-version.sh into dracut.sh

`dracut-version.sh` is only sourced by `dracut.sh`. So move defining
`DRACUT_VERSION` into `dracut.sh` and remove `dracut-version.sh`. This
allows removing code for sourcing this file.

ci(busybox): disable DMSQUASH

Disable running DMSQUASH test without coreutils until a proper fix is
available.

Follow-up to 362ea81 .

ci: sort container job configs by tag name

Sort container job configs by tag name because the tag name is used as
job name.

feat: add yamllint config

Add a yamllint config allowing a line length of 120 characters for the
beginning. The next steps would wrap the too long lines and add a linter
job running `yamllint .`.

ci: use container tag name as job name

Use the full container tag name as job name (e. g. `ubuntu:devel-amd`).
This is shorter and easy to read.

ci: remove duplicate ubuntu image jobs from container-extra

The `ubuntu:devel` and `ubuntu:rolling` container images are already
built by the container job. There is no need to build them on the
container-extra job as well.

test: add test case for booting root=live:<URL>

Add a test case for booting `root=live:<URL>` before adding new features
to the `livenet` Dracut module. Numbering the test is tricky, because it
uses live boot (range 30-39) and basic networking (range 60-69).

ci: only publish to GitHub Pages for dracut-ng repo

Forking dracut-ng will also fork the CI configs and pushes to the forked
main branch will trigger the publish job which will fail (unless pages
are explicitly enabled).

So only publish to GitHub Pages when triggered from the dracut-ng
repository.

ci: also push tags when container jobs were triggered manually

The CI jobs for building the containers might be triggered manually. The
event name is `workflow_dispatch` then and the tag update would not be
pushed. That defeats the purpose of running those jobs manually.

ci: name container jobs after CI name

Name the container jobs after their CI name instead of `amd64` since
they also build `arm64` images.

chore(gitignore): ignore html files in test directory

I sometimes convert the test log file to HTML using `ansi2html` to make
the logs nicer to read. Ignore those HTML files in `.gitignore` as well.

chore(gitignore): sort .gitignore file

```
LANG=C sort .gitignore | sponge .gitignore
```

ci: explicitly install python3 in containers

Explicitly install python3 in the containers to allow testing the
`livenet` module using Python 3 `http.server` as HTTP server. Many of
the containers already have Python installed as dependency.

chore(gitignore): ignore .testdir and test logs

`test/test-functions` creates a `.testdir` file with `-$TEST_RUN_ID` as
suffix. It also create log files named `server.log` and
`test${TEST_RUN_ID:+-$TEST_RUN_ID}.log`.

Make the `.gitignore` pattern match those files.

test(DMSQUASH): fix autooverlay test checks the entire root.img

The test searched for the marker string in the entire root.img, but
the string also existed literally in test-init.sh embedded in the
first partition, causing a false positive. Fix by extracting and
searching only the second (overlay) partition.

Fixes: #2054

test(DMSQUASH): fix do_live_overlay not being called

The test disk image contained raw rootfs instead of the live
structure (LiveOS/rootfs.img), so FSIMG was empty and do_live_overlay()
was never called. Fix by using the live structure on disk.

test(DMSQUASH): add sync after writing the marker

The change is done to ensure it is flushed to the persist
partition before shutdown.

chore: update obsolete comments and documentation

Change the comment and make it more generic.

ci: rename network-systemd job to match the derauct module name

network-systemd is testing the systemd-networkd dracut module.
Let us use the dracut module name as the name of the job.

chore(dracut): call the public determine_kernel_image function

Instead of repeating and reimplementing the function to find
kernel image, call the public function.

Follow-up to df93355 .

feat(dracut): expose determine_kernel_image as a public function

Expose determine_kernel_image as a public and documented helper
function.

test(DRACUT-CPIO): correct test_check condition

Partial revert to correct test_check condition.

The current code checks if dracut-cpio is found in PATH and skips
the test in case dracut-cpio is found.

Follow-up to b687756 .

test: use assertion.sh hook for test-root

The test-root `test-init.sh` script can run test case specific test
assertion if `/assertion.sh` is present.

Use this infrastructure for `TEST-30-DMSQUASH`. This fixes the issue
(found by Nadzeya) that `test-init.sh` tried to read `/proc/cmdline` but
`/proc` was not mounted and the directory did not exist. `test-init.sh`
takes care of mounting `/proc`.

fix(systemd-networkd): ensure zzzz-dracut-default.network cleanup

zzzz-dracut-default.network should be only installed when
systemd-network-generator does not generate any files in
files in /run/systemd/network .

Place dracut-default.network in /usr/lib/dracut/
and do not change /usr as part of managing .network
files in initramfs.

Follow-up to 523c9b0 .

feat(dracut): add busybox support for 3cpio and enhanced_cpio

3cpio and enhanced_cpio is already supported with coreutils.

This PR adds support for 3cpio and enhanced_cpio for busybox as well.
busybox stat does not support `file-system` syntax, instead
it supports `-f` syntax only.

test(DMSQUASH): use test_marker_check

Use `test_marker_check` to shorten the test case code.

ci: replace non-standard PLATFORM with standard TARGETARCH

The simple goal of this PR is to remove unnecessary variable
to make the code more readable and maintainable.

chore(dracut): remove support for 255 error for is_qemu_virtualized

Treat the return value as a boolean and not an integer, to simplify
the API before potentially exposing this API as a public API.

ci(Alpine): add support for EFI stub and ukify

alpine:edge has support for EFI stub and ukify. Adding these
packages would allow the projuct to increase CI test coverage.

fix(dracut): remove trailing null characters from SBATs when building UKIs

SBAT of kernel has null character paddings at the end. Using tools
like ukify will display massive amount of '\0' in SBAT. Ukify is
doing ".rstrip('b\x00')" when merging SBATs.

test(KERNEL-INSTALL): check kernel-install result

The kernel-install call should create an `initrd` file that the test
will use later in `test_run`. Check that this file has been created to
ease debugging in case of a failure.

test: drop duplicate check for -daemonize

`run-qemu` checks twice for the `-daemonize` parameter.

Fixes: a3f73298f287 ("testsuite: refactor qemu options")

fix(i18n): remove Gentoo workaround that is no longer needed

Gentoo no longer sets KEYMAP to something like "-u pl2", instead
it is set to "pl12".

This piece of code is part of the very original commit of the i18n
dracut module from 2010 - 87122af

There is no mention of '-u' in the oldest version of the wiki from 2013
https://wiki.gentoo.org/index.php?title=Keyboard_layout_switching&diff=1320347&oldid=16937

Remove this workaround that is no longer used or tested to
make it easier to reason about the code.

refactor: move defining inst_sysusers to dracut-functions.sh

inst_sysusers is a public interface to dracut modules, move it
to `dracut-functions.sh`.

Document inst_sysusers in the man page as from now on it is a
public interface.

test: run QEMU with a timeout unless daemonized

Dracut tests might hang. The Dracut CI sets a timeout to kill those
hanging tests, but downstream might not configure something similar.

Run QEMU with a timeout (unless daemonized) to avoid hanging tests
forever.

The slowest tests executions that I have seen on Debian/Ubuntu:

* 33:44 for test 11 (5 client tests) on Ubuntu resolute on armhf
* 101:58 for test 60 (19 client tests) on Debian unstable on ppc64el
* 19:58 for test 70 (3 client tests) on Ubuntu resolute on arm64
* 22:35 for test 71 (4 client tests) on Ubuntu resolute on arm64
* 52:48 for test 72 (8 client tests) Debian unstable on ppc64el

These slow tests take between 5:22 and 6:45 for each client tests on
average (ignoring the setup cost). So set the timeout to 10 minutes as
default.

Fixes: https://bugs.debian.org/1121884

ci: unskip FULL-SYSTEMD on containers where it is passing

This test is now passing on arm openSUSE and gentoo. Skip it.

test(FULL-SYSTEMD): do not depend on -smbios qemu feature

smbios support is architecture dependent and not widely supported.

Using smbios when available does not increase the test coverage
for dracut significantly.

Partial revert of 817dd6125 .

ci(basic): correct syntax to exclude several tests

Make sure tests 20 and 26 are excluded as intended by fixing
GitHub Action syntax.

Follow-up to 1798677 .

ci: skip running failing tesst due to 2021

Temporary skip running tests until
https://github.com/dracut-ng/dracut-ng/issues/2021
is resolved.

Follow-up to 1798677 .

ci: simplify GitHub Action job naming

network-manager dracut module is the default networking provider.

Remove forcing network-manager networking and simplify naming.

ci: skip running failing tesst due to 2021

Temporary skip running tests until
https://github.com/dracut-ng/dracut-ng/issues/2021
is resolved.

ci: skip running tests that are failing due to 1988

Temporary skip running tests until
https://github.com/dracut-ng/dracut-ng/issues/1988
is resolved.

ci: run network-systemd tests on arm as well

Add arm to the test matrix for network-systemd.

ci: move mkosi testing into daily testsuite

mkosi is not default/native in any of the test containers and it
does not seem to be stable.

This PR moves running mkosi reference test into
daily testing so that the dedicated GitHub Action can be just
disabled without a PR.

ci(openSUSE): container build fix

ruby3.4-rubygem-asciidoctor is now called ruby4.0-rubygem-asciidoctor.

ci: run network-legacy tests on arm as well

Add arm to the test matrix for network-legacy.

ci: remove leftover and duplicated GitHub Action

daily-systemd-arm64 GitHub Action is no longer needed as it is
covered by daily-systemd.

Follow-up to a43bd7a .

ci: fix GitHub Action syntax

excluding architectures requires {runner: 'ubuntu-24.04', tag: 'amd'} .

ci: combine omitsystemd x64 and arm64 into one GitHub action

Running tests on arm64 is just as stable as x64, there is
no need to separate them. Combine them into one GitHub
action should make it easier to reason about regressions.

ci: combine systemd x64 and arm64 into one GitHub action

Running tests on arm64 is just as stable as x64, there is
no need to separate them. Combine them into one GitHub
action should make it easier to reason about regressions.

ci: combine hostonlystrict x64 and arm64 into one GitHub action

Running tests on arm64 is just as stable as x64, there is
no need to separate them. Combine them into one GitHub
action should make it easier to reason about regressions.

ci: combine network-manager x64 and arm64 into one GitHub action

Running tests on arm64 is just as stable as x64, there is
no need to separate them. Combine them into one GitHub
action should make it easier to reason about regressions.

ci: combine basic x64 and arm64 into one GitHub action

Running tests on arm64 is just as stable as x64, there is
no need to separate them. Combine them into one GitHub
action should make it easier to reason about regressions.

ci(busybox): make test 80 compatible with busybox

BusyBox ln does not support the -r argument. This argument
can be removed from the test suite without losing test coverage.

Now that the test runs with busybox, add it to the busybox daily
testsuite.

ci(busybox): make test 30 compatible with busybox

busybox dd understands bs=1M but it does not understands bs=1MiB.

Now that the test runs with busybox, add it to the busybox daily
testsuite.

ci: run TEST_CONTAINER_COMMAND before configure runs

Move running TEST_CONTAINER_COMMAND during CI tests
earlier so that packages can be installed/uninstalled
before configure runs.

ci: daily busybox tests

Add a GitHub action to run and pass as many of the
existing tests as possible without installing coreutils.

ci: modularize GitHub Actions for daily tests

Move each job into its own GA yaml file so that each job
can be individually enabled/disabled via the GitHub web interface.

This change prevents triggering all test runs every time
the monolithic yaml file is modified.

test(KERNEL-INSTALL): layout and uki_generator set must be set on Gentoo

Set layout, initrd_generator, and uki_generator for kernel-install.

Fixes https://github.com/dracut-ng/dracut-ng/issues/2018 .

ci(alpine-busybox): grep is no longer required

busybox grep is supports all the required functionality and
command line arguments to pass dracut's basic test.

Installing GNU grep on top of busybox is no longer required.

Follow-up to 2de5129 .

ci: verify marker images consistently

Use grep -F -a to check marker images after test runs.

This affects test evaluation only and does not modify dracut
core logic.

ci: add a test run for basic tests using busybox

This test prevents regressions when running basic tests on
Alpine with busybox.

fix(dracut): use proper dracut logging when possible

The recent restructuring of the code allows using proper dracut logging
in more areas of the code.

Follow-up to 8552a0f .

ci(alpine-busybox): alpine container with busybox

The coreutils binaries are not installed and only busybox
binaries are available.

This container is meant to prevent regressions when running
basic test with busybox.

refactor(dracut-install): simplify boolean evaluation

Checking a boolean with `== false` can be simplified to use the `not`
operator.

test: use syntax compatible with busybox implementation

busybox du only support `-s` for summary and `-b` for block-size.

Follow-up to d4af288f0 .

ci: drop alpine:latest and run tests only on alpine:edge

alpine:edge has been very stable CI environment for this project,
so let's promote it to the main CI and at the same time
let's retire alpine:latest.

The goal of this PR is to reduce time and computation on the CI
without loosing significant test coverage.

feat: always preserve file ownership

Currently file ownership is almost always preserved, except when
DRACUT_CP variable is used.

Make all file copying consistent and always preserve file ownership
by passing `-p` to `cp`.

Follow-up to 9ef73b6ad .

fix(dracut): ensure that inst is called after DRACUT_NO_XATTR is computed

`inst` calls dracut-install which requires DRACUT_NO_XATTR.

Move code block around to make sure DRACUT_NO_XATTR is set before
`inst` is called.

Follow-up to 941b18d .

feat(no-xattr): no longer support no-xattr config

Starting with dracut release v110, no-xattr is the default
config, so it is no longer desired to maintain a separate config
file for no-xattr.

Follow-up to 941b18d .

test(SYSTEMD): run with --no-hostonly-cmdline

This test aims to run without the `initqueue` module, but the `base` module
depends on it if `$hostonly_cmdline == "yes"` [1]. Although the test ends
successfully, the log shows some errors because `dracut-lib.sh` is not present
if the `base` module cannot be installed:

```
dracut[E]: Module 'base' depends on module 'initqueue', which can't be installed
...
/usr/bin/dracut-cmdline-ask: line 3: /lib/dracut-lib.sh: No such file or directory
[    2.108191] dracut-cmdline[254]: /usr/bin/dracut-cmdline: line 6: /lib/dracut-lib.sh: No such file or directory
[    2.129548] dracut-pre-udev[259]: /usr/bin/dracut-pre-udev: line 6: /lib/dracut-lib.sh: No such file or directory
...
[    3.176822] dracut-pre-pivot[368]: /usr/bin/dracut-pre-pivot: line 7: /lib/dracut-lib.sh: No such file or directory
...
All OK
```

[1] https://github.com/dracut-ng/dracut-ng/blob/bf29f4b79aee9771800dffe78857014970be117e/modules.d/80base/module-setup.sh#L8-L12

chore(Makefile): use cp -a consistently

`cp -a` is used in all call sites except one.
Update the outlier to use the -a flag for consistency.

Follow-up to a0d12aa7d .

test(NETWORK): do not set net.ifnames=0

Increase test coverage by letting CI test containers to decide
the value of net.ifnames.

Change the test expectation to handle both net.ifnames=0
and net.ifnames=1.

feat(dracut): drop unreachable code for dracutbasedir/initdir

`dracut.sh` sets the variables `dracutbasedir` and `initdir`. Then it
creates the `initdir` directory. So checking those variables again can
be dropped.

Follow-up: 4cb4917e1222 ("refactor: fold dracut-init.sh into dracut.sh")

chore(deps): bump luizm/action-sh-checker from 0.9.0 to 0.10.0

Bumps [luizm/action-sh-checker](https://github.com/luizm/action-sh-checker) from 0.9.0 to 0.10.0.
- [Release notes](https://github.com/luizm/action-sh-checker/releases)
- [Commits](luizm/action-sh-checker@v0.9.0...v0.10.0)

Removed the `-s` argument (stands for `--simplify`) as this
argument now overrules .editorconfig and moved setting simplify
to .editorconfig.

test: drop --auto=yes from mdadm call

mdadm 4.5 emits following warning:

```
mdadm: --auto is deprecated and will be removed in future releases.
```

So drop `--auto=yes` from the `mdadm --create` calls.

fix(dracut): move comment back to related dracut_args variable

Commit 58dad7025b01 added the comment "store for logging" next to the
`dracut_args` variable. Move that comment back to this place.

refactor(dracut-functions): put functions first

For better readability put all the functions first in
`dracut-functions.sh` and put the executed code last.

feat(dracut): disable xattr when creating cpios

Disable xattr when creating cpio, but do not change
the default for squashfs/erofs.

Move setting the default for DRACUT_CP later in the code to
account for the newly set defaults.

Fixes: https://github.com/dracut-ng/dracut-ng/issues/1561

fix(dracut): source dracut-functions.sh before calling dwarning

`dracut-functions.sh` sources `dracut-logger.sh` which defines the
`dwarning` function. `dracut.sh` might call `dwarning` before
`dracut-functions.sh` is sourced.

`dracut-functions.sh` calls `find_binary` and `dlog_init` when sourced.
`find_binary` needs `dracutsysrootdir` set and `dlog_init` needs
`stdloglvl`, `sysloglvl`, `kmsgloglvl`, `maxloglvl`, `fileloglvl`,
`logfile`. Move sourcing `dracut-functions.sh` as early as possible, but
after setting those variables.

Follow-up for 8d9887b
Fixes: https://bugs.debian.org/1124479

chore: move net udev rules to net-lib dracut modules

The net-lib dracut module is designed to be always installed when
networking is enabled in the generated initramfs.

Move networking related udev rules to net-lib dracut modules from the
udev-rules dracut module.

The motivation behind this change is to increase modularity,
stay consistent with other dracut modules and potentially
increase performance when networking is not required in the
initramfs.

ci(alpine): install openRC and build-base

alpine-base package is required to make the
container bootable and have the openRC services
available.

The alpine-base package is not installed by default in the alpine
container (only the alpine-baselayout package is installed).

Instead of explicitly installing make, install build-base meta-package
for future proofing.

feat(dracut): print $uefi with --printconfig

Allow the enviroment (e.g. package managers) to discover
if uefi is enabled or not.

Similar to 71a713bb2 .

ci: remove stalebot config file

There is no plan for this project to maintain the a stalebot
(or introduce any other stalebot alternative).

fix(dm): add explicit rootfs-block dependency

Device mapper operates on local storage typically
configured by the rootfs-block module.

This change tightens dependencies to ensure that including only
the dm module via `dracut -m dm` produces a functional initramfs.

chore: remove support for 64-device-mapper.rules

64-device-mapper.rules use to be a Gentoo specific file,
which is now obsolete even on Gentoo.

Reverts 5d7298.

chore: reduce the scope of shellcheck exceptions

The motivation behind this commit is to be able easily
identify unused functions in dracut.sh going forward.

feat(dracut): add support for --ukify, --no-ukify

Introduce a dracut option to enable/disable using ukify to
create UKI even if ukify is installed.

Fixes: https://github.com/dracut-ng/dracut-ng/issues/1592

fix: grammatical errors

chore: move inst_opt_decompress to i18n dracut module

`inst_opt_decompress`, `inst_decompress` and get_decompress_cmd
functions are only used in the i18n dracut module.

These functions were never documented as public functions
for dracut modules.

Fixes: https://github.com/dracut-ng/dracut-ng/issues/1966