feat(base): create /proc if it does not exists

Change tests to test for this scenario.

chore: teach labeler to ignore two-digit numeric sort code

feat: create a documentation site

This is a proposal to create a documentation site with Antora
(https://antora.org/) which works with the existing asciidoc files.

As motivation; there is a somewhat difficult to navigate (due to length and no
indexing) single .html file made already, and a wiki page that is kept
separately and links back to several docs, which can be viewed via github's
rendering.  I'm of the feeling that incorporating docs into the main workflow
leads to a better outcome, especially taking advantage of pipelines to publish
on commit ensuring things are kept up-to-date.

There isn't much too this other than the framework stuff and some minor syntax
fixes to some of the files.  "make doc_site" outputs the site in build/.

man/dracut.asc becomes the index page; everything else remains in place where
it was.  After discussion we decided to remove the dracut.html file and
generation to avoid confusion over what is current.

I've added in custom css and lightly styled the output site to keep the vibe of
the older html page.

In terms of developer workflow, I know little about nodejs and have not found
it onerous to figure out; "nodejs" installed by your distro and "npx antora"
"just works"; it's very self-contained.

I've included the sample github workflow to publish it to github pages on
commit taken from the Antora docs -- it may need tweaking by project admins.

The output is basic but functional.  The nice thing about a framework like this
is the almost limitless options for improvement :)

ci: combine running advanced networking tests and disable them

These test are flaky and these dracut modules are not under
active development.

test: only set VMLINUZ if it is not already set

Make it consistent with KVERSION and only set it if
it is not already set.

test: reorganize tests

10-19: core modules
20-29: multiple boot drives
30-39: live boot
40-49: systemd
60-69: basic networking (nfs)
70-79: advanced networking (iscsi, nbd)
80-89: dracut binaries

old -> new
----------
01 -> 10
02 -> 40
03 -> 11
04 -> 41
05 -> 42
10 -> 20
11 -> 21
12 -> 22
13 -> 25
14 -> 23
15 -> 24
16 -> 30
17 -> 25
18 -> 12
20 -> 60
30 -> 70
35 -> 71
40 -> 72
50 -> 61
60 -> 62
62 -> 81
63 -> 82
98 -> 80

ci: remove sudo from all test containers

docs: update NEWS.md and AUTHORS for release 105

fix(systemd-cryptsetup): change the ordering for consistency

All other systemd modules are numbered as 01.

fix(systemd): remove typo from the dracut module name

Follow-up 5551746088633116a28f3ded9d7003f378b6cd17.

fix(udev-rules): move relevant rules from systemd

Also install elogind into Alpine and Void containers.

fix(dmsquash-live): checkisomd5 is installed into /usr/bin

fix(man): use US English spelling for initialization

fix(man): correct spelling of initramfs

docs: update NEWS.md and AUTHORS for release 104

fix: install test infrastructure

fix(network): call both check_module and module_check

Add back testing the module with check_module as well as module_check.

Without this PR, on some Linux distributions (e.g. Void) adding `network` meta module
no longer works as it tries and fails to install the preferred netowrking backend
(network-manager).

chore: .asc --> .adoc in preparation to improve manual generation

Antora seems to require .adoc.

https://asciidoctor.org/docs/asciidoc-recommended-practices/ recommends
.adoc extension.

ci: remove unused interactive debugging tools

Remove vi(m), strace, tcpdump, wget, less.

ci: add swtpm for TPM emulation

fix(hwdb): only install /etc/udev/udev.hwdb in hostonly mode

"$udevconfdir"/hwdb.bin already grabs /etc/udev/udev.hwdb
in hostonly mode.

chore: create a dedicated directory for each reference config

This change helps with downstream packaging as packaging will no
no longer needs to rename the file.

test: move test scripts under test/

test: move dracut.conf.d conf dir for tests under $TESTDIR

This will ensure that the directory gets cleaned up after test run.

test(UEFI): prepare for testing with more than one kernel command line

Use SMBIOS Type 11 Strings support in systemd-stub
(io.systemd.stub.kernel-cmdline-extra).

test: move test dracut modules under the test/ directory

test: remove unnecessary intermediate cleanups

test: always keep the generated initrd to help writing assertions

This should also make the tests to run faster.

test: move more code out from tests into common test functions

test: create a config for test test-makeroot test-root

test: consolidate TEST_KERNEL_CMDLINE

test(BASIC): move driver regression testing out to a different test

test: showmount is not required to run the tests

test: tcpdump is not required to run the tests

test(MULTINIC): ifcfg dracut module is no longer available

test: remove dracut-lib.sh dependency from real rootfs

test: remove less from the required binaries for tests

ci: do not force rootfstype, let the initrd figure it out

remove 'rw' from kernel command line as that is the default

ci: set rd.retry consistently by only setting it in one place

chore(tests): search for bash in $PATH to improve portability

test(UEFI): use ukify if available

Create test coverage for using dracut with ukify.

feat(rescue): move command line arguments to 50-rescue.conf

The benefit of this change is that even if kernel-install
is not used (e.g. direct user invocation), the correct
kernel command line options will be set for the generated
rescue image.

fix(rescue): make rescue always no-hostonly

Currently the rescue image is only set to no-hostonly if it is
generated via dracut-rescue.install. Make the rescue image
generation more predictable and consistent by setting no-hostonly
right in the rescue config.

docs: clarify --print-cmdline

perf(systemd-initrd): do not depend on base module

Make sure /etc/initrd exist.

Test SYSTEMD-INITRD confirms no regression as this tests
now no longer includes the base module and it still passes
the boot tests with systemd (hence the perf tag).

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

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

---
updated-dependencies:
- dependency-name: luizm/action-sh-checker
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>

chore: remove logtree

logtree was introduced for testing Fedora on Travis CI.
After the transition to GitHub Action logtree is no longer used.

fix(dracut): --list-modules should imply --no-kernel as well

This will ensure that 'dracut --list-modules' works well in a container.

test(UEFI): add test coverage for 50-uki-virt.conf

feat: config example for cloud provider uki vm

This is an example configuration for a 'unified kernel image'.

The key benefit of a unified kernel is that its secure boot
signature covers the initrd and cmdline contents, allowing
a trustworthy measured boot process with attestation, which
is not practical with locally generated initrds/cmdlines.

The initrd in this example only needs a very small set of
block driver modules present, in order to be usable across
KVM, Hyper-V and Xen hypervisors which will cover essentially
all common public and private clouds.

fix(dracut): don't apply aggressive strip to kernel modules

Unlike ordinary binaries, kernel module will be unusable if stripped
with "-p". Fix this by always use "-g" only.

So far it didn't cause many issues since most kernels have their
modules signed or compressed so this is skipped.

Signed-off-by: Kairui Song <kasong@tencent.com>

docs: document more creation functions for dracut modules

fix: typo in variable name

refactor(dracut-install): simplify open() call in cp()

Flipping `S_IFMT` gives the file mode bits.

test: continue to force network-legacy for server when needed

This change allows us to address the remaining test issues one by one.

feat(dracut.sh): add --add-confdir option

When generating kdump's initrd, we want to keep [omit_]dracutmodules
empty and let kdump to handle the modules. And we don't want to
affect the first kernel's initrd, so we cannot place our conf file
to /etc/dracut.conf.d or /usr/lib/dracut/dracut.conf.d.

This patch adds a new option to allow user to add an extra configuration
directory to use *.conf files from. If the dir not exists, will look for
confdir's subdir.

After that, kdump can use "--add-confdir kdump" if
/usr/lib/dracut/dracut.conf.d/kdump exists, to apply its own dracut conf.

See also:
https://github.com/rhkdump/kdump-utils/issues/11
https://github.com/rhkdump/kdump-utils/pull/31

Suggested-by: Dave Young <dyoung@redhat.com>
Signed-off-by: Lichen Liu <lichliu@redhat.com>

perf(systemd-initrd): initrd.target is already the default

Avoid creating an extra symlink under /etc inside the
generated initrd.

initrd.target is already the default.

feat(fips): add support for UKIs

Kernel integrity check in FIPS module is incompatible with UKIs as neither
/boot/vmlinuz-`uname-r` nor /boot/.vmlinuz-`uname-r`.hmac are present. UKI
is placed to $ESP\EFI\Linux\<install-tag>-<uname-r>.efi and if a .hmac file
is present next to it, it is possible to do similar check.

Note, UKIs have a 'one size fits all' command line and 'boot=' is not expected
to be set. Luckily, if the UKI is systemd-stub based then we can expect
'LoaderDevicePartUUID' variable containing PARTUUID of the ESP to be set. Mount
it to /boot using the existing logic.

Signed-off-by: Vitaly Kuznetsov <vkuznets@redhat.com>

fix(nvmf): install (only) required nvmf modules

nvme_rdma was not installed, even if it was required, whereas
nvme_tcp was installed in non-TCP setups. nvme_fabrics will be
pulled in automatically by any transport module and doesn't
need to be installed explicitly.

Fix it.

fix(nvmf): require NVMeoF modules

Signed-off-by: Martin Wilck <mwilck@suse.com>

feat(systemd): always install libsystemd libraries

fix(dracut): do not add all lib subdirs to `LD_LIBRARY_PATH` with `--sysroot`

On systems with too many library subdirectories, the current approach causes
`Argument list too long` errors, and the initrd also fails to build.

This patch does not fix the original issue by itself (i.e., libsystemd libs not
found), so all the dracut modules that require libraries stored in
subdirectories must explicitly install them using `inst_libdir_file`, which
already successfully handles the `--sysroot` prefix.

Fixes e0b876823d9c608db7132cab9e5edd62543a27ae

Co-authored-by: Antonio Alvarez Feijoo <antonio.feijoo@suse.com>

fix(dracut-install): use correct data type for pid

test: continue to force network-legacy for server when needed

This change allows us to address the remaining test issues one by one.

revert(test): network dracut package needs to be added with '-a'

reverts 7445b72a7e6e2435d5af39d26e61c960612f4c85

fix(network): handle '-m network'

call module_check instead of check_module

ci: run tests in verbose mode for Ubuntu

Ubuntu is the most active supporting verbose test configuration and
running tests in V=2 mode downstream.

ci: remove mksh as there is no longer a dracut module supporting it

ci: install mkosi into a few containers to be able to use it for tests

mkosi-initrd is a portable way to create a reference initrd and compare
it to the output of dracut generated initrd.

ci: make container file names and tag names consistent

ci: python3-pefile is a dependency for ukify

test(SYSTEMD-INITRD): demonstrate minimal initrd passing test

fix(systemd-udevd): make systemd-sysctl, systemd-modules-load optional

fix(systemd-sysctl): systemd-modules-load is not a dependency

After= in systemd-sysctl.service does not imply dependency
on systemd-modules-load.

ci(alpine): use clang instead of gcc for more test coverage

chore(dracut-install): fix clang build

Fix the following build error:

dracut-install.c: unused parameter 'ctx' [-Werror,-Wunused-parameter]

fix(dracut-install): handle correctly sysrootdir with trailing '/'

Signed-off-by: Ondrej Kubik <ondrej.kubik@canonical.com>

fix(dracut-install): do not assume handled path starts with sysrootdir

When using --sysrootdir argument, we cannot assume fulldstpath and
fullsrcpath always start with sysrootdir. When dracut_install is
called on destination directory, this results in passing pointer which
is often beyond valid buffer.

Signed-off-by: Ondrej Kubik <ondrej.kubik@canonical.com>

fix(dracut-functions): allow for \ in get_maj_min file path

as the path might be f.e. /dev/disk/by-partlabel/EFI\x20System\x20Partition

which would produce Warning 'grep: warning: stray \ before x' in get_maj_min

Resolves: !505

fix(fips-crypto-policies): make it depend on fips dracut module

feat(test-root): only include debug module if V is set to 2

This PR enables CI to run faster by default (V=1).

When debugging (V=2) debug module will be included as before.

ci: test plymouth dracut module in more containers

test(FULL-SYSTEM): remove non-systemd dracut modules from the test

i18n is not longer required after 238378ad2b7367900a0050bb9fc5b9eab5294cba.

ci: change default fstype for Arch and openSUSE

Default (when test allows it) is now XFS for Arch
and btrfs for openSUSE.

test(BASIC): add support for XFS

XFS filesystem labels can be at most 12 characters long,
so move the test case for the ' rdinit=/bin/sh' label
to TEST-02 instead and keep TEST-01 simple.

XFS filesystem must be larger than 300MB.

test(BASIC): allow to run the test with various fstypes

Tested with the following fstypes:
 - ext2
 - ext3
 - ext4
 - btrfs
 - jfs

ci: add more fstypes support (xfs, jfs, f2fs)

This PR is just a container change, no tests are added or removed.

chore: remove boilerplate

It is not required to redefine empty functions.

fix(udev-rules): remove systemd-specific rules

These rules are already present in the systemd dracut module.

test(NBD): fix how rootfs is built

Change in systemd dracut module exposed that thest NBD had a dependency
on a particular dracut module rule that is not needed in production.

Change the test and align it with other tests.

fix(systemd): do not set unused target as the default

initrd.target is set as default in systemd-initrd dracut module.

fix(systemd): /sbin/init is not required inside initrd

test: network dracut package needs to be added with '-a'

'-m network' does not really work as it is not able to include
the actual networking backend as check_module call with
always fail.

fix(Dockerfile-Gentoo): explicitly pull in all build dependencies

Closes: https://github.com/dracut-ng/dracut-ng/issues/630
Signed-off-by: Andrew Ammerlaan <andrewammerlaan@gentoo.org>

test: document and fix extra verbose mode (V=2)

Set 'rd.debug' for all tests  in 'V=2' mode to make
it more verbose than 'V=1' test mode.

fix(systemd-networkd): remove basename dependency

The basename tool was not listed in the requirements and is also not needed.
Also see https://github.com/dracutdevs/dracut/commit/4c216b1db6a86373549e13b60250a7fcf94417b9

ci: add more packages to Debian and Ubuntu containers

Increase test coverage. Some of the newly added packages
are needed to to install some dracut modules and are already
installed for other CI containers.

revert(systemd): trigger systemd-vconsole-setup.service only on demand

Revert 6b095274fb935ffb7639d1ea7e51f9bd0f487726.

Enable systemd-vconsole-setup.service always when it is avaiable
as it usually gets triggered by udev rules anyways.

fix(systemd-networkd): make sure default network is always last

Fixes #618

chore: remove obsolete old syntax for rd.driver.* and rd.live

Remove support for the following arguments:
- rdblacklist
- rdinsmodpost
- rdloaddriver
- check
- rdlivedebug
- live_dir
- liveimg
- overlay
- readonly_overlay
- reset_overlay
- live_ram