sd-bus: Add sd_bus_message_peek_type docs

Merge pull request #15504 from poettering/cmsg-find-pure

just the recvmsg_safe() stuff from #15457

Merge pull request #15472 from keszybz/dbus-api-docs

A few more dbus api documentation updates

update TODO

Merge pull request #15543 from poettering/fix-ubsan-sd-bus

sd-bus: work around ubsan warning

shared: Don't try calling NULL callback in bus_wait_for_units_clear

BugLink: https://bugs.launchpad.net/bugs/1870930

Merge pull request #15544 from poettering/fix-journalctl-namespace

sd-journal: fix namespace check

Merge pull request #15538 from poettering/nspawn-no-netns

nspawn: politely refuse --image= when run inside non-host netns

Merge pull request #15527 from Werkov/mkosi-opensuse

Add mkosi config for openSUSE Tumbleweed

mkosi: Add openSUSE params file

The setup is meant to run against openSUSE Tumbleweed and install
minimum packages necessary for successful build and passing tests.

To speed up incremental build an external build directory is used.

run: don't wait for start job to complete when running interactively anyway

Otherwise we'd not read the services input while waiting for the job to
wait, and there's no point in waiting for the job anyway if we wait for
the unit to stop ultimately.

Fixes: #15395

tree-wide: use recvmsg_safe() at various places

Let's be extra careful whenever we return from recvmsg() and see
MSG_CTRUNC set. This generally means we ran into a programming error, as
we didn't size the control buffer large enough. It's an error condition
we should at least log about, or propagate up. Hence do that.

This is particularly important when receiving fds, since for those the
control data can be of any size. In particular on stream sockets that's
nasty, because if we miss an fd because of control data truncation we
cannot recover, we might not even realize that we are one off.

(Also, when failing early, if there's any chance the socket might be
AF_UNIX let's close all received fds, all the time. We got this right
most of the time, but there were a few cases missing. God, UNIX is hard
to use)

socket-util: add recvmsg_safe() wrapper that handles MSG_CTRUNC

test: add a test case for #15528

sd-journal: don't check namespaces if we have no namespace to go by

Fixes: #15528

nspawn: refuse politely when we are run in the non-host netns in combination with --image=

Strictly speaking this doesn't really fix #15079, but it at least means
we won't hang anymore.

Fixes: #15079

nspawn: minor simplification

Merge pull request #15530 from ssahani/lpr-dhcpv4-option-9

network: add support to DHCPv4 server/client option 9 LPR

sd-bus: Add sd_bus_message_get_error/errno docs

acpi-fpdt: mark structures as packed

Let's make sure the alignment doesn't matter.

sd-bus: work around ubsan warning

ubsan complains that we add an offset to a NULL ptr here in some cases.
Which isn't really a bug though, since we only use it as the end
condition for a for loop, but we can still fix it...

Fixes: #15522

sd-bus: Add sd_bus_get/set_allow_interactive_authorization docs

Merge pull request #15546 from poettering/pid1-serialize-comand-fix

core: make sure to restore the control command id, too

Merge pull request #15516 from poettering/nspawn-resolv-conf

beef up --resolv-conf= options of systemd-nspawn

nspawn: some minor modernizations

man: Fix typo "multiplied with" -> "multiplied by"

sd-bus: Add sd_bus_message_at_end docs

Merge pull request #15517 from DaanDeMeyer/sd-bus-monitor-docs

sd-bus: Add sd_bus_set/is_monitor docs

Merge pull request #15507 from poettering/bus-log-api

add generic bus interface for setting log level that can be implemented by any daemon

core: make sure we don't get confused when setting TERM for a tty fd

Fixes: #15344

man: document that VirtualEthernetExtra= has nothing to do with Bridge=

Fixes: #15402

core: make sure to restore the control command id, too

Fixes: #15356

core: some minor clean-ups/modernizations

man: document the new --resolv-conf= options

nspawn: beef up --resolve-conf= modes

Let's add flavours for copying stub/uplink resolv.conf versions.

Let's add a more brutal "replace" mode, where we'll replace any existing
destination file.

Let's also change what "auto" means: instead of copying the static file,
let's use the stub file, so that DNS search info is copied over.

Fixes: #15340

resolve: move resolv.conf path definitions to shared header

That way we can use it from nspawn.

networkctl: Add support to display LPR servers

sd-network: Add support to retrive LPR servers

network: Add support send and receive LPR servers

sd-network: DHCPv4 Add support to send and receive LPR servers.

Merge pull request #15526 from bluca/start_stop_wait_debug

Add debug log when a job in the activation queue is not runnable

core: add debug log when a job in the activation queue is not runnable

When a job is skipped due its dependencies not being ready, log
a debug message saying what is holding it back.
This was very useful with transient units timing out to figure
out where the problem was.

mkosi: Unify environment for unit tests

Some testcases in test-execute rely on existence of user groups with
certain gids. However, their existence is not universally granted [1].
Although the test could be skipped in their absence and give up testing
some code paths, different approach was chosen -- create dummy groups in
the testing image.

[1] See how systemd-sysusers allocates gids (e.g.
src/test/test-uid-range.c).

test: Simplify hostname checking

Both hostname and uname utilities boil down to uname(2) syscall. Reduce
tests dependency footprint by using uname for checking hostname too.

mkosi: Use distro-invariant rootprefix

Distributions may be build with various configs, e.g. customized
rootprefix. It'd be unmaintanable to have specific mkosi.build for each
supported distro. Hence, make the build script flexible yet distro
oblivious.

Merge pull request #15519 from DaanDeMeyer/sd-bus-message-read-strv-docs

test: correctly clean up test artifacts

Remove the artifact files indicating test result (testok, failed, and
skipped) just before running the test so we always get the latest and
most relevant result instead of incorrectly consuming previous results.

Discovered in https://github.com/systemd/systemd/pull/15378#issuecomment-616801873

util: return the correct correct wd from inotify helpers

We need to propagate the acquired watch descriptors because our callers
are counting on them.

[Lennart: this is split out of #15381 and simplified]

core: minor error code handling fixes

sd-bus: Clarify sd_bus_list_names results ownership

sd-bus: Add sd_bus_message_read_strv docs

Merge pull request #15520 from mrc0mmand/various-codebase-improvements

tree-wide: various codebase improvements

Merge pull request #15443 from ddstreet/use_gateway_backwards_compatible

Make UseGateway= default backwards compatible, and fix UseGateway/RoutesToDNS

test: verify RoutesToDNS= is independent of UseGateway=

tree-wide: fix spelling errors

Based on a report from Fossies.org using Codespell.

Followup to #15436

tree-wide: formatting tweaks reported by Coccinelle

network: honor SetDNSRoutes= even if UseGateway=False

test: modify/add tests for UseRoutes= and UseGateway= configuration

The last commit changed the UseGateway= default to the value of UseRoutes=
so the tests need to check for all combinations of the two parameters.

network: change UseGateway= default to UseRoutes= setting

Anyone previously using the UseRoutes=false parameter expected their
dhcp4-provided gateway route to be ignored, as well.  However, with
the introduction of the UseGateway= parameter, this is no longer true.

In order to keep backwards compatibility, this sets the UseGateway=
default value to whatever UseRoutes= has been set to.

sd-bus: Add sd_bus_list_names docs

test: drop Disk (Size|Free|Floor|Ceiling) fields prior comparing

The disk attributes can take some time to update on certain filesystems,
so let's strip them from inputs of both `homectl` and `userdbctl` before
comparing them to avoid unexpected fails.

Also, switch from `cmp` to `diff` to make a potential test fail a bit more
debuggable.

Fixes: #14755

update TODO

sd-bus: Add sd_bus_set/is_monitor docs

sd-bus: Rewrap sd_bus_set_server docs at 109 columns

core: add log_get_max_level check optimization in log_unit_full

Just as log_full already does, check if the log level would result in
logging immediately in the macro in order to avoid doing
unnecessary work that adds up in hot spots.

man: remove gendered pronoun and reindent a paragraph

docs: use "polkit" to refer to PolicyKit

See d35f51ea848ca76bd3747db69e8c5dd864e82bc3 for justification.

First use in each file is turned into a link to the documentation page.

man: fix two typos

Pointed out by @boucman and @DaanDeMeyer during review.

man: timedate1(5) — add missing descriptions

man: hostname(5) — add description of methods and properties

core: implement generic log control API in PID1 too

It has slightly different setters in place, so it needs some special
love, which is easy enough though.

core: use generic implementations of log level/target bus propertier getters

The setters are slightly different, hence keep them as they are for now.

tree-wide: implement new log control API dbus interface in all our daemons

resolved: replace private log level control API with generic one

The property was just added, let's replace it again. Given that it was
never released this should not be an API breakage.

log-control-api: add generic D-Bus interface for querying/setting log level/target

Let's define a new, generic bus interface that any daemon can implement
for querying/setting the log level.

We can turn this into something more powerful later on, but for now,
only expose three properties: the log level, log target and the syslog
identifier (with the former two being writable).

This is supposed to be generic, so that it can be implemented by 3rd
party daemons too, eventually.

tree-wide: use "hostname" spelling everywhere

It's not that I think that "hostname" is vastly superior to "host name". Quite
the opposite — the difference is small, and in some context the two-word version
does fit better. But in the tree, there are ~200 occurrences of the first, and
>1600 of the other, and consistent spelling is more important than any particular
spelling choice.

man: reorder hostname1(5)

core: automatically add udev dependency for units using RootImage=

We use udev to wait for /dev/loopX devices to be fully proped hence we
need an implicit ordering dependency on it, for RootImage= to work
reliably in early boot, too.

Fixes: #14972

Merge pull request #15508 from keszybz/add-dbus-entities-to-index

Add dbus entities to index

Merge pull request #15505 from keszybz/man-sd-hwdb-sd-journal

Document remaining sd-journal and sd-hwdb functions

man: document how to get the boot menu with zero time-out

Fixes: #15125

man: add SD_HWDB_FOREACH_PROPERTY with an example

man: add description of all the sd-hwdb funtions

man: add markers to put all dbus entities in the directives index

Follow-up for f92c8d1c67bcdeba097e3203d8aafe3a31230ada.

directives.index:
- This index contains 3398 entries in 19 sections, referring to 333 individual
+ This index contains 4316 entries in 19 sections, referring to 333 individual

man: run systemd1(5) through the updater

For some reason I must've forgotten this page in 4fb222c4b2.

Merge pull request #15476 from boucman/directive_dbus

Generate systemd.directive entries from dbus documentation

Merge pull request #15495 from keszybz/resolve-debugging-and-stub-handling

Resolve debugging and stub handling

Merge pull request #15314 from keszybz/network-server-access-functions

Define network server access functions

Merge pull request #15502 from DaanDeMeyer/sd-bus-exit-on-disconnect-docs

sd-bus: Add sd_bus_get/set_exit_on_disconnect docs

Merge pull request #15503 from DaanDeMeyer/sd-bus-get-docs

sd-bus: Add sd_bus_get_scope/tid/unique_name docs

man: add sd_j_open_namespace as refname

This was forgotten in 241c8f67f65a1051068a1728daaca5bc49183c69.

check-api-docs: sd_journal_open_container is deprecated

man: document sd_journal_*_with_location

sd-bus: Rewrap sd_bus_set_close_on_exit + small fixes

sd-bus: Add sd_bus_get_scope/tid/unique_name docs

sd-bus: Rewrap sd_bus_set_description docs

sd-bus: sd_bus_get_fd docs typo fix

update-dbus-docs: automatically add variablelist for introspected items

Add a <variablelist/> tag after every programlisting we auto-generate that
will be read by make-directive-index to cross-reference all dbus elements.

sd-bus: Rewrap sd_bus_get_fd docs

sd-bus: Small sd_bus_set_server doc fix