Drop "first assignment wins" logic

From experience in the systemd repository's usage of presets, we've
learned that we want to have fixed values for certain settings for
presets that cannot be overridden by either the CLI options or by
global config. Good examples are that the Format= of a base image
should always be "directory" and the Format= of an initrd image
should always be "cpio" or that Bootable= should always be "no" for
both the base image and the initrd image and their list of packages
should not be affected by any packages specified on the CLI.

The issue is that with "first assignment wins" logic, we need to add
an explicit "override" mechanism which almost all settings in these
presets would then use to make sure they can't be changed by CLI
options. This seems rather backwards, and is a good indication that
any settings configured in config should not be overridden by settings
set on the CLI.

Even disregarding usage of presets, any existing mkosi config will almost
certainly not be written to expect arbitrary changes in the config due
to options set on the CLI.

Also, it's currently not entirely trivial to set default values for
presets from the global config, because any values set in the global
config cannot be overridden anymore by presets. By not doing "first
assignment wins" logic, this becomes trivial as the global config can
simply set a default value and it can be overridden by presets.

Of course by removing "first assignment wins" logic, we do introduce
the issue again that "first assignment wins" solves in the first place,
which is that it becomes possible to assign a value to a setting, match
on that value and then change the setting later. We acknowledge this by
documenting it in the manual. Also, in some cases, this is exactly what
you want. For example, if you want to use a Fedora rawhide tools tree to
build CentOS 8 images, you have to first match on distribution == centos
and then set Distribution=fedora afterwards for the tools tree preset, so
this actually makes perfect sense in some cases.

While this is technically a compat break, it will only be noticed by users
doing advanced stuff with mkosi, which AFAIK does not exist yet outside of
the systemd repo. In fact even the systemd repo was not broken by this change,
so we should be OK with making it, given the large benefits we get out of it.

This commit also simplifies the interfaces of the parser and matching callbacks
to not take the namespace as an argument anymore, but to simply take the existing
value as an argument instead.

Use logging instead of print()

Reword output docs a bit

Merge pull request #1827 from DaanDeMeyer/manifest

Manifest fixes

Do not generate manifest if it is not enabled

Do not generate manifest by default

Generally users are not going to be interested in the manifest so
let's not generate it by default to avoid cluttering the output
directory.

doc: Suggest using a reflink supported FS

Merge pull request #1822 from DaanDeMeyer/fix-archive

Archive fixes

Make's bwrap() read-only logic optional

We only really need this when running scripts, so let's make it
configurable and only enable it when running scripts.

Use default_factory to evaluate Path.cwd() later

Otherwise, we don't take --directory into account as Path.cwd() is
evaluated on module import.

Document our default systemd-repart definition files

Make sure we remove /var/lib/dbus/machine-id from the image

Fixes #1818

mkosi: adjust messages about missing cert+key

Rename mount_image() to mount_base_trees()

Also don't log about mounting the base trees if we're not actually
going to mount them.

Merge pull request #1814 from DaanDeMeyer/uki-name

Drop "mkosi" from UKI names

Drop outdated comment

Drop "mkosi" from UKI names

Let's not leak that the image was generated by mkosi into the image
via the UKI name.

Fix bootloader path

Make sure unit and preset directories exist in configure_ssh()

Fixes #1811

Merge pull request #1797 from DaanDeMeyer/grub

Add back BIOS support using grub

Add mention of BuildSources= change to NEWS.

Add grub EFI support

Note that we only generate the necessary menu entries for the grub
configuration to chainload into our generated UKIs, we do not yet
install grub for EFI ourselves as this is a distribution specific
mess that we still need to figure out. On Fedora, because the
shim and grub2-efi packages install directly to /boot which we
redirect to /efi, this is sufficient to boot with grub on EFI by
simply installing the shim and grub2-efi packages.

For other distributions, a post install or finalize script will be
necessary that installs grub (and optionally shim) to the correct
locations in the ESP.

Add back BIOS support using grub

Let's add back support for booting on BIOS using grub. This comes
with the following limitations:

- grub does not support UKIs on BIOS, so we set up the individual
components instead
- grub cannot search partitions by PARTUUID, so we're forced to have
it find the ESP by partition number instead.

We opt to generate grub.cfg ourselves instead of relying on grub-mkconfig.
grub-mkconfig is basically like kernel-install but for grub configuration,
it has a ton of distro specific cruft that we want to ignore, so we simply
don't use it and generate the grub configuration ourselves.

To allow for unprivileged installation of grub, we can't use grub-install
as it insists on opening the root device and probing its filesystem, which
isn't possible unprivileged. Instead, we run grub-mkimage and grub-bios-setup
ourselves, and manually copy the required files to the ESP.

We use the ESP to store the kernels, initrds and grub config. In the event
that grub adds support for UKIs on BIOS in the future, we can simply modify
the generated grub configuration to use our generated UKIs instead.

Add QemuBios= option

Make ESP logic bootloader independent

Let's simply check if a bootloader was placed in the right location
instead of having systemd-boot specific checks.

Add none Bootloader option

This disables adding any EFI bootloader altogether. Preparation
for adding BIOS support.

Run tput smam to make sure line wrapping is reenabled

When running seabios, it disables line wrapping for some weird
reason, so let's make sure we reenable it before we exit.

Drop XFS workaround

Heuristic was changed upstream so should work OOTB now.

Make /boot/efi a symlink to /efi

Let's make sure all EFI stuff is installed to /efi by making
/boot/efi a symlink to /efi.

ci: Install tzdata on Debian/Ubuntu

To make sure a timezone is set up so systemd-firstboot doesn't
prompt for it on boot.

Unset TMPDIR in apivfs_cmd()

dnf seems to have issues with this as well so let's unset TMPDIR
whenever we set up APIVFS as that's a good indication something is
going to chroot and we should unset TMPDIR.

ci: Install base group for Arch

Packages have implicit dependencies on base so let's install it.

Reset terminal cursor if tput is available

When interrupting dnf5 or other programs, they sometimes mess up
the terminal cursor. So let's make sure we reset the cursor state
when we exit mkosi if tput is available.

Merge pull request #1804 from DaanDeMeyer/boot

systemd-boot improvements

Set --no-variables when we invoke bootctl

We already don't install variables because we're operating on a
root directory, but if we set --no-variables we don't get warnings
from bootctl about it.

Rename install_bootloader() to install_systemd_boot()

Add Bootloader option

For some use cases, we don't want systemd-boot but to boot directly
from a UKI, so let's support that by bringing back the --bootloader
option.

repart: Set sector size using SectorSize=

Use paths and path_read_text to process mkosi.version file

Reword systemd version requirement a bit

We should use wording that still makes sense when reading documentation
from the distro packaged version of mkosi as well. Let's also mention
that the systemd requirement is only for bootable disk images.

Make sure we pass through TMPDIR to run()

Run with --offline=no when Subvolumes= is used in repart definition files

skip passwd bind mounts if the path does not exist on the host

Merge pull request #1790 from DaanDeMeyer/grub

Various cleanups

Document QemuCdrom=

Fix typo

Make sure we Clean up cd-rom image after qemu exits

Fix gray ansi color definition

We weren't actually getting gray output with the previous definition.
Let's steal the one from systemd to make it work.

Import full modules instead of individual members

Let's lean more towards importing full modules except for a few
exceptions like typing and Path from pathlib.

Rework make_image_output()

Instead of returning a tuple containing all the bits we're interested
in, let's just return a typed version of the repart json output and
calculate what we need based on that in install_unified_kernel(). We
also move the split paths logic into make_image().

Introduce build_initrd() and build_kernel_modules_initrd()

Remove git blame section from README

The paragraph introduced in #585 became stale after #1777 was merged.

update man page link

Log systemd-repart json output at debug level

Use copy.deepcopy() to copy os.environ

Otherwise any changes we make to os.environ propagate into our
shallow copy.

Add QemuCdrom= option

This attaches the image as a CD-ROM instead of a hard drive to the
virtual machine.

set Dir::Etc option on apt based distros

Pass through stdin when we call systemd-repart with --image=

When mounting an image, systemd's dissect logic might prompt for
verity/encryption passphrases. Let's make sure the user can enter
those if needed.

Make sure we use python-pefile from the tools tree

Make sure we load pefile early

Otherwise we'll run into trouble later if we're using a tools tree.

Release 15.1

Update NEWS

Merge pull request #1781 from keszybz/man-page-prep

Add script to prepare man pages, retitle release commits

Retitle release commits to "Release vNN"

I think this is just nicer and stands out more in the git log.

Add helper to build the man page

Don't use capsh to figure out capabilities

Merge pull request #1779 from DaanDeMeyer/tmpfs

Make sure the private tmpfs in bwrap() doesn't hide workspace

Only unshare network namespace if we have CAP_NET_ADMIN

Make sure the private tmpfs in bwrap() doesn't hide workspace

The workspace might be in /tmp so we need to make sure we mount it
first before we mount the workspace so that the workspace is on top
of the private tmpfs.

Merge pull request #1778 from DaanDeMeyer/all-packages

List all subpackages in pyproject.toml

Remove unused package-data globs

Also add mkosi.1 to package-data

Add mkosi.md to package-data

Don't try to tun timedatectl or ssh-add if not available

List all subpackages in pyproject.toml

Bump version numbers for v15

Remove .git-blame-ignore-revs file

This has outlived its usefulness, there's no need to ignore the black
commit anymore when doing a git blame due to its age.

Update do-a-release.sh script

Reorder fields of MkosiConfig to match summary() and MkosiConfigSettings

Merge pull request #1679 from behrmann/helpverb

Make docs available via the help verb.

add --doc-format option for choosing the output of the documentation verb

add NEWS entry for documentation verb.

add symlink to docs in resources

action: Don't install pandoc

make mkosi docs from resources available via the documentation verb

This allows, especially when running different versions of mkosi, to always
have the right documentation on hand no matter how that version of mkosi was
installed.

move mkosi.md to mkosi/resources

Replace dd with pefile's get_data() method

ci: Add job to check that we can still generate the man page

Introduce preset dependencies

Instead of building presets in alphanumerical order, let's introduce
a proper concept of dependencies. Dependencies are configured with
the new "Dependencies=" option in the new "[Preset]" section. All
presets configured with "Dependencies=" are built before the current
preset.

We drop the alphanumerical preset in favor of explicit dependencies.

Set agetty autologin credentials by default

Eventually we'll replace --autologin with these but for now let's
set both.

Make sure we output signed kernel instead of unsigned kernel

Fixes #1589

Prefer gcpio over cpio

Fixes #1201

Set GPGTTY when calling gpg

Fixes #351

Don't reverse list option values found in the same option

Items from earlier settings should take precedence over items from
later settings, but that doesn't mean we should reverse items found
in the same setting.

Fixes #1707

Touch /usr/lib/clock-epoch during the build

We'll handle the reproducible builds part of this together with all
the other changes for reproducible builds.

Fixes #1218

Run finalize script after selinux relabel

Let's make the finalize script true to its name and run it as the
final operation before we start packaging things up.

Merge pull request #1763 from DaanDeMeyer/udev

Install udev instead of systemd-udev

Make sure we install udev in the initrd

Follow up for 7bb87d7d011162f503b842b02bbe9e157cb6f116

Install extra packages for centos/alma/rocky to fix CI failure

This increases the size of the generated image a bit which makes
sure repart calculates a minimal partition size for the XFS
filesystem so that populating the partition doesn't run out of space.

Install udev instead of systemd-udev

Installing systemd-udev means running into
https://bugzilla.redhat.com/show_bug.cgi?id=2183279 so let's install
udev which avoids that issue.