Rework ini file parsing

Python's configparser module is rather inadequate for our purposes.
Specifically, it's built around every setting only being specified once
in a config file and even though we got it to kind of parse more than
one of the same setting with our own custom dict type, there's a lot of
limitations involved. Specifically, assigning the empty value is
impossible with the current approach. To avoid all these issues, let's
introduce our own ini parser.

This also splits off the matching logic into a new method match_config()
and moves setting the debugging level just after we've parsed CLI options
so we get debug messages from the parser as well.

Read paths after parsing configuration files

Let's first take into account the main configuration file before parsing
any configured paths. This allow the main configuration files to reset
any configured settings without resetting its own defaults configured via
paths.

Ignore ssh configuration files when running ssh

When in a user namespace, the ssh config files from /etc/ will be
owned by nobody which makes ssh fail. Let's ignore these configuration
files when running ssh to avoid such failures.

Fixes #1848

Use shlex.join in more places

normalize mtime

If set, the time stamp from SOURCE_DATE_EPOCH is used to normalize
mtime of files. We also need to pass the environment trough when
mkosi is invoking itself.

Co-authored-by: Malte Poll <mp@edgeless.systems>

Don't fail if tput commands fail

Let's consider these best effort, no need to fail mkosi if we can't
fix the terminal.

Fixes #1846

config: Test last assignment wins with defaults

Merge pull request #1844 from bcbnz/overlay-options

Disable index and metacopy options of overlayfs

Move mount options into original declaration.

Disable index and metacopy options of overlayfs.

If these are enabled (e.g., if the kernel enables them by default), the
mount will fail if the upper directory has been earlier used with a
different lower directory, such as with a build overlay that was
generated on top of a different temporary root.

Closes #1841.

Fix passwd check

Fixes #1842

Merge pull request #1836 from DaanDeMeyer/defaults

Support configuring default values for settings

add config setting seed to set systemd-repart --seed

Co-authored-by: Paul Meyer <49727155+katexochen@users.noreply.github.com>

Introduce config_default_compression() default factory

Move all environment handling into load_environment()

Support configuring default values for settings

This allows configuring the default value for a setting. This is
useful to set a custom default value for a setting while still
allowing an explicit value from the CLI to take precedence.

To make this work properly in combination with default_factory, we
also introduce a new default_factory_depends field that lists all
the other settings that a setting's default_factory implementation
depends on. Then, when we finalize a setting's default value, we also
finalize the default value of settings it depends on so that its
default_factory function can do the right thing.

We also integrate the "paths" field from MkosiConfigSetting in this.
By default, paths will modify the defaults namespace instead of the
regular namespace, meaning their values will only be used if the
setting is not explicitly configured. The only exception to this are
mkosi.extra/, mkosi.skeleton/ and mkosi.repart/, whose values are just
merged with any explicitly specified directories.

doc: make formatting more uniform

- Quotes are exchanged in favour of emphasis markers. Emphasis for terms,
  strong emphasis section names.
- Section names formatted as truetype/monospace are exchanged from strong
  emphasis.
- Section names are written consistently.
- Literals for settings, setting snippets and paths are formatted as
  monospace.
- Paragraphs that are formmated incorrectly in the markdown extensions for
  definition lists (using :) are moved such, that generate a single visual
  block in the pandoc generated man page.
- Superfluous quotes are removed.
- A numbered list is used for the execution flow to make it easier to follow
  and to visually seperate it from the list of mounted directories.
- URLs are formatted as links with adjacent text, since this formats them
  less bare in the generated man page.
- The remaning http URL is moved to https

propagate SOURCE_DATE_EPOCH when calling systemd-repart

Fix globbing

Drop list reset on empty value

This does not work properly with python's configparser, which will
insert empty lines when doing something like the following:

```
Packages=
       abc
```

Instead, we restore the "!" operator for lists to remove values from
the list as it did originally instead of preventing values from being
added.

Mention backward compat break regarding overrides in man page

Merge pull request #1830 from DaanDeMeyer/config

Drop "first assignment wins" logic

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