man: say that machine-info doesn't have to exist

Esp. CHASSIS is only useful as an override. Make that clear in the description.

Fixes #3496.

man: tweak descriptions of how tmpfiles should be started

We shouldn't imply that invocation without any parameters is OK.
Also, mention that the service can be restarted.

Fixes #8684.

man: describe quoting and specifiers in Environment=

Fixes #10604.

man: move quoting description to systemd.syntax

We use very similar quoting rules in many places. Let's move this
lengthy text out of systemd.service page.

man: explain how to invoke tmpfiles for debugging

Fixes #11914.

man: mention that != matches nonexistent keys too

Fixes #15984.

man: reorder match types in udev rules

The plural version should always be adjacent to the singular one.
And the plural should not be explained before the singular one…

man: add footnote explaining why "localhost" query is sent out to the network

I tried to make the explanation brief, but this isn't so easy. It seems better
to push this out to a footnote instead of the main text.

Fixes #16584.

man: move motivational explanation to footnote

man: describe the syntax for {Job,}{Running,}TimeoutSec=

Fixes #16644.

Also break the text into paragraphs to make it a bit easier to read.

man: move description of $SYSTEMD_SYSVINIT_PATH to the only user

man: reuse common-variables in systemd(1)

This requires a bit of gimnastics, but I think it's still better than
status quo ante, and better than duplicating the text.

basic/log: align tables

man: describe various logging configuration variables

Fixes #17484.

This patch affects systemctl(1), as well as all man pages that include
all of common-variables.xml, i.e. most of our command line tools.

man: rename less-variables→common-variables

Some are not about less, e.g. $SYSTEMD_URLIFY.

coredump: indent comment

man: describe coredump fields

We save a wealth of information about the process, but this might not be
immediately obvious.

man: make systemd-coredump and coredumpctl descriptions more accessible

Fixes #17910: we didn't clearly explain that coredumps may exist without
journal entries, and vice versa.

Also, make the examples more concrete, and use '$' instead of '#' to avoid
suggesting that running as root is required. The text is extended a bit in
various places. In the description of systemd-coredump, the details of executor
separation are split out to a separate subsection, since they are rather
detailed and not necessary to understand for normal use.

man: remove details of ManagedOOMPreference implementation

man: advertise shared drop-ins more

systemd.unit(5) is a wall of text. And this particular feature can be very useful
in the context of resource control. Let's avertise this cool feature a bit more.

Fixes #17900.

man: fix two issues in udev(7)

Fixed #18050.

man: say that hostname must can be a fqdn or not

Fixes #18426

timesync: rename variable to match config name

PollIntervalMinSec and PollIntervalMaxSec use the same pattern, but
RootDistanceMaxSec had switched orderd in the code.

man: explain settings in timesyncd.conf(5)

Fixes #18508.

man: drop misplaced spaces and parenthesization

man: use markup more in description of ManagedOOMPreference=

Follow-up for d8a4d64bc37ad21381f584b6c25792995584c7a2.

man: fix grammaro

signal-util: make -1 termination of ignore_signals() argument list unnecessary

Clean up ignore_signals() + default_signals() + sigaction_many() a bit:
make it unnecessary to explicitly terminate the signal list with -1.
Merge all three calls into a single function that is just called with
slightly different parameters. And eliminate an unnecessary extra
iteration in its inner for() loop.

No change in behaviour.

Merge pull request #18018 from bluca/mount_images_overlay

Add ExtensionImages directive to form overlays

meson: refuse when prefix is not a child of rootprefix

This is most likely to happen when setting one but not the other.

Note that we already warn when rootprefixdir != rootprefix_default,
at the very end.

test: skip tests if cgroup isn't mounted

Debian builds in a chroot without cgroup mounted, so tests expecting
to access cgroup will fail with ENOMEDIUM, so skip the tests in that
situation.

cgroup: don't generate BPF firewall unsupported warning on wrong unit

Let's generate the warning on a unit that actually needs the BPF
firewall, and not confusingly already for a sibling of one.

format-table: don't suppress trailing whitespace in first line

We underline the first line, hence we shouldn't suppress the whitespace,
otherwise the line will end early.

Follow-up for: 71894e18313e41a72cecdc77fea5037f95d6903f

treewide: fix spelling

network: Implement B.A.T.M.A.N. Advanced interface type

resolved: don't discard mDNS queries with bad flags

Even though RFC 6762 specifies these bits MUST be zero, it also says they MUST
be ignored on reception.

resolved: don't discard mDNS packets with ip6.arpa RRs

ip6.arpa is also a valid domain name to put in mDNS packets.

Merge pull request #18771 from yuwata/timedate-fix-set-local-rtc-18391

timedate: do not ignore fix_system argument in SetLocalRTC method

timedate: do not ignore fix_system argument in SetLocalRTC method

Fixes #18391.

test: skip TEST-56-OOMD if systemd-oomd is not installed

Fixes #18775

network: use IPMasquerade=both instead of yes

Follow-up for 4c72d851cd007e945a85811f89376a2675daa1a5.

clock-util: rename function argument

doc,man: fix-typo (hierachy -> hierarchy)

Merge pull request #18730 from yuwata/dhcp6-client-do-not-set-t1-t2-18090

dhcp6: do not set T1 and T2 in IA_PD option or friends

Translated using Weblate (Serbian)

Currently translated at 66.6% (126 of 189 strings)

Co-authored-by: Frantisek Sumsal <frantisek@sumsal.cz>
Translate-URL: https://translate.fedoraproject.org/projects/systemd/master/sr/
Translation: systemd/main

Merge pull request #18589 from yuwata/network-nexthop-drop-unnecessary-nexthops

network: drop unnecessary nexthops

Update NEWS

Fix typos, improve /dev exec/noexec description

bootspec: assume that the root dir is at the top of its file system

Fixes: #17746

Merge pull request #18763 from poettering/cov-fixes

A bunch of coverity fixes

Merge pull request #18765 from keszybz/more-docs

NEWS and one more man page addition

man: add a description of how manager env block is set

Add ExtensionImages directive to form overlays

Add support for overlaying images for services on top of their
root fs, using a read-only overlay.

core/namespace: reafactor applying mounts in a separate function

The setup_namespace code to apply mounts is a big if block that
keeps growing, so refactor it in a separate function.

sysext: split parsing SYSTEMD_SYSEXT_HIERARCHIES in a common helper

NEWS: add ConditionCGC=v12 and the hostname stuff

efi stub: accept it if our loaded image has no FilePath field set

The firmware spec doesn't really say whether FilePath of the LoadedImage
protocol may be NULL or not. So far we assumed it to be non-NULL, but
apparently the FreeBSD UEFI chainloader sets it to NULL. Handle this
gracefully.

(Noticed and tracked down by Alexander Schreiber)

Fixes: #18733

core: fix memory leak in error path

Coverity 1431998

resolved: don't dereference ->scope unless set

Coverity 1446388

shared: fix memory leak in error path

Coverity 1446676

icmp6-util: add missing variable initialization

Coverity 1446712

dissect-image: initially fds[] array fully

THe previous code wasn't wrong, but it's certainly nicer to avoid a
partially uninitialized array here, hence Coverity has a point
complaining about this.

Coverity 1446731

resolved: fix minor memory leak

Coverity 1446992

core: fix stack-use-after-scope

Fixes a bug introduced by f70e6fb471a4eeed8e2a4a7c608beabbb0aba8be.

Fixes #18753.

po: remove basic fedora.zanata.org configuration

Zanata is not used anymore and its current configuration is not useful
anyway since the master branch was renamed to main.

Merge pull request #18751 from anitazha/oomdconditions

units: add Conditions for systemd-oomd.service

test-network: add tests for dropping unnecessary nexthops

network: nexthop: drop unnecessary nexthops

Similar to addresses or routes, this makes networkd drops unnecessary
nexthops on configuring links or when a link is dropped.

network: nexthop: read protocol in received netlink message

Preparation of later commits.

sd-netlink: introduce sd_rtnl_message_nexthop_get_protocol()

man: various improvements to systemd.generator(7)

In particular, make clear the .d/*.conf unit file drop-ins are OK to
generate from generators.

Inspired by: https://lists.freedesktop.org/archives/systemd-devel/2021-February/046148.html

Revert "meson: remove one more instance of install_dir:bindir"

This reverts commit 5ffa2eaa541b718122a3422e911ef95f4c9981d7.

It seems that if install_dir is not specified, meson decides install path
based on file type, and non-executable binary files are installed under
/usr/share.

kernel-install is a script. So, we need to set install_dir argument
explicitly.

Fixes #18754.

dhcp6: do not set T1 and T2 by dhcp6_option_append_pd() in client

Fixes #18090.

dhcp6: do not set T1 and T2 by dhcp6_option_append_ia() in client

dhcp6: make dhcp6_option_parse_{address,pdprefix}() return -EINVAL when received address or prefix is refused

And then the caller ignores the error.
Otherwise, `ret_liftime_valid` is not set even if they succeeds.

README: add config_psi as requirement for systemd-oomd

units: add Conditions for systemd-oomd.service

Prompted by https://bugzilla.redhat.com/show_bug.cgi?id=1927148 and
https://bugzilla.redhat.com/show_bug.cgi?id=1931181.

Adds condition check for cgroups v2 and PSI, which systemd-oomd cannot
start without.

dhcp6: do not use input value before checking

resolved: add another explanatory message to stub resolv.conf files

Apparently people do "cat /etc/resolv.conf" and not realize that they
are looking at a file in /run.

meson: bump version numbers

NEWS: add contributors

resolved: actually use the specified rrsig argument

The argument only exists to be used to override/fill in the RRSIG record
of the answer item. Hence actually use it instead of ignore it.

(Not sure how this got lost earlier.)

Fixes: #18714

Merge pull request #18741 from poettering/stub-no-cname

resolved: don't follow CNAMEs in the stub anymore

shared/condition: add ConditionControlGroupController=v1|v2

Before, we only allowed conditionalizing on controllers, not the hierarchy.
This commit extends this to allow a simple check for v1 (i.e. classic or hybrid),
and v2 (full unified).

An alternative approach would be to add a separate Condition for this, but I'm
not too keen on that, considering that v1 is already being deprecrecated
(c.f. 82f3063218).

MountImages: parse unit specifiers after permissive hyphen

The permissive bit it not something a specifier might synthetise

Merge pull request #18745 from keszybz/stop-using-fstrings

Stop using fstrings

test-dns-packet: fix leak of DnsResourceRecord object

NEWS: a few more entries for v248-rc1

I left the stuff related to [NextHop] out. There are still
patches outstanding, and we can add a comprehensive entry once
things reached the final form.

Merge pull request #18704 from keszybz/fallback-hostame-override

Allow overriding of fallback hostname through envvar and os-release field

resolved: stick CNAME targets into main answer section in stub replies

resolved: add dns_resource_record_get_cname_target() helper

This determines the redirection target from a CNAME or DNAME RR given it
matches some given RR key.

resolved: remove duplicate comment

Practically the same comment is a few lines up covering both parts
anyway, let's remove one.

resolved: update comment in DNS stub code a bit

There's no "answer_auxiliary" object anymore, it's all one "answer"
object, and we have per-item flags that tell us which section things are
from, i.e. from the main answer section, or the additional or
authoritative ones.

resolved: don't follow CNAMEs in the stub anymore

CNAME following was broken by 775ae35403f8f3c01b7ac13387fe8aac1759993f
where we'd not properly collect RRs along the CNAME path. Good thing
though is that we don't have to anymore: since we nowadays propagate all
sections of the upstream replies into the cache and back to stub clients
all the information should already be available anyway, and there's no
need for us to collect it.

Fixes: #18690

Merge pull request #18575 from bugaevc/aa

Set the AA bit in answers for synthetic records & mDNS

Revert "generate-dns_type-gperf: modernize python syntax"

This reverts commit b0a336a66929ed2a146888178157bf1af5c8598c.

Fixes #18708.

Stop using f-strings in generate-sym-test.py

This partially reverts 7857b6e8383f5debab9544ef3abb15a27830fafa.
Debian 9 has python3.5 which does not have f-strings yet.

Partially fixes #18708.

docs: align tables vertically to top

Fixes #18706.

Translated using Weblate (Slovak)

Currently translated at 24.8% (47 of 189 strings)

Co-authored-by: Frantisek Sumsal <frantisek@sumsal.cz>
Translate-URL: https://translate.fedoraproject.org/projects/systemd/master/sk/
Translation: systemd/main

Merge pull request #18718 from yuwata/network-nexthop-blackhole

network: introduce Blackhole= setting in [NextHop] section

Merge pull request #18734 from poettering/cryptsetup-description-escape

cryptsetup: unescape ID_PART_ENTRY_NAME udev field