docs/SYSTEMD_FILE_HIERARCHY: format text

docs/PORTABLE_SERVICES: format text

docs/USER_RECORD: format text

docs/PORTABILITY_AND_STABILITY: format text

docs/DISTRO_PORTING: format text

docs/INHIBITOR_LOCKS: format text

docs/USER_NAMES: format text

docs/TIPS_AND_TRICKS: format text

docs/INCOMPABILITIES: format text

docs/HOME_DIRECTORY: format text

docs/JOURNAL_EXPORT_FORMATS: format text

docs/ELF_PKG_METADATA: format text

docs/UIDS-GIDS: format text

docs/SYSLOG: format text

docs/SECURITY: format text

docs/PRESET: format text

docs/PASSWORD_AGENTS: format text

docs/GROUP_RECORD: format text

docs/OPTIMIZATIONS: format text

docs/HACKING: format text

docs/MINIMAL_BUILDS: format text

docs/DESKTOP_ENVIRONMENTS: format text

docs/DEBUGGING: format text

docs/DAEMON_SOCKET_ACTIVATION: format text

docs/CREDENTIALS: format text

docs/COREDUMP: format text

docs/CONVERTING_TO_HOMED: format text

docs/CONTRIBUTING: format text

docs/CODE_OF_CONDUCT: format text

docs/CATALOG: format text

docs/BUILDING_IMAGES: format text

docs/BOOT: format text

docs/BACKPORTS: format text

docs/AUTOPKGTEST: format text

docs/ARCHITECTURE: format text

docs/API_FILE_SYSTEM: format text

docs/FAQ: update logind man page link and fix relative link

docs/PORTABILITY_AND_STABILITY: update internal links

docs/JOURNAL_FILE_FORMAT: update journal links

docs/INITRD_INTERFACE: update link

separate usr is broken

docs/CONTAINER_INTERACE: update vm-or-container-manager link

docs/GROUP_DELEGATION: update links

to The New Control Group Interfaces and Writing VM and Container Managers

docs/WRITING_RESOLVER_CLIENTS: update manpage link

docs/WRITING_RESOLVER_CLIENTS: format text

docs: add pax control groups

and adapt links

docs/TIPS_AND_TRICKS: update faq link

docs/DEBUGGING: add screenshot and fix path to it

docs/WRITING VM_AND_CONTAINER_MANAGERS: update manpage link

and container interface link

docs/WRITING_NETWORK_CONFIGURATION_MANAGERS: update manpage links

docs/WRITING_DISPLAY_MANAGERS: update links

to desktop environments and logind manpage

docs/WRITING_DESKTOP_ENV: update links

to 'bus api of logind' and 'inhitor locks'

docs/THE_CASE_FOR_THE_USR_MERGE): update link to 'seprate usr is broken'

docs/MINIMAL_BUILDS: remove last sentence due to missing link

http://kdzbn.homelinux.net/libcap-add-pkg-config.patch
This link is a 404, so we removed the whole sentence.

docs/INHIBITOR_LOCKS: update logind d-bus api link

and fix freedesktop wiki link

docs/CONTROL_GROUP_INTERFACE: update links

docs/BOOT: update bootloader specification link

docs/BACKPORTS: close parenthesis

docs/HACKING: fix jinja link

docs/HACKING: link mkosi webpage

and remove one of two mkosi github links

docs/CODING_STYLE: remove whitespace

docs/ARCHITECTURE: link test/readme.testsuite

core: add counter for soft-reboot iterations

Allow to query via D-Bus how many times the current booted system has
been soft rebooted

analyze: show only current times after soft-reboot

The firmware/loader/kernel times are no longer relevant for the startup
sequence on soft-reboot, so use only the userspace timestamps

core: add SoftRebootStartTimestamp

Will be useful to calculate how long it took to shut down the system before starting
in the new root

core: do not serialize timestamps that are re-measured on soft-reboot

Otherwise the de-serialization overwrites the timestamps taken after
soft-reboot (e.g.: userspace start/finish) and sd-analyze shows bogus
data

Merge pull request #31789 from jsitnicki/socket-pass-fds-to-exec

Pass socket FDs to all ExecXYZ= commands in socket unit but ExecStartPre=

resolved: always return the validated answers when validating

We normally expect sd-resolved only to return the validated subset of a
validated response. In some cases we give up on validating, because we
have enough information already to conclude the answer is bogus.

Let's be sure to always reply with only the validated subset in these
cases too, so that we don't return bogus answers and confuse primitive
clients that won't see the SERVFAIL rcode.

resolved: minor dnssec fixups

Fixes: ce5b9d5b3c24 ("resolved: request DS with DNSKEY")

shared/logs-show: restore infinite loop avoidance for corrupted journals

Fixes a bug introduced in e44f06065bf20e8d0e4adacff61350ebd36f299e: it was
supposed to be a refactoring, but unfortunately FOREACH_ARRAY is implemented
using a for loop, so when the 'goto finish' was replaced by 'break', it only
broke the inner loop, leading to a infinite loop.

home: fix typo

Follow-up for 5ec87d577f92effe27a62e965e02a6f9a40f81cc.

test: integration test for PassFileDescriptorsToExec= option

Check if socket file descriptors are passed to ExecXYZ= commands from the
socket unit depending on whether PassFileDescriptorsToExec= option is set.

socket: pass socket FDs to all ExecXYZ= commands but ExecStartPre=

Today listen file descriptors created by socket unit don't get passed to
commands in Exec{Start,Stop}{Pre,Post}= socket options.

This prevents ExecXYZ= commands from accessing the created socket FDs to do
any kind of system setup which involves the socket but is not covered by
existing socket unit options.

One concrete example is to insert a socket FD into a BPF map capable of
holding socket references, such as BPF sockmap/sockhash [1] or
reuseport_sockarray [2]. Or, similarly, send the file descriptor with
SCM_RIGHTS to another process, which has access to a BPF map for storing
sockets.

To unblock this use case, pass ListenXYZ= file descriptors to ExecXYZ=
commands as listen FDs [4]. As an exception, ExecStartPre= command does not
inherit any file descriptors because it gets invoked before the listen FDs
are created.

This new behavior can potentially break existing configurations. Commands
invoked from ExecXYZ= might not expect to inherit file descriptors through
sd_listen_fds protocol.

To prevent breakage, add a new socket unit parameter,
PassFileDescriptorsToExec=, to control whether ExecXYZ= programs inherit
listen FDs.

[1] https://docs.kernel.org/bpf/map_sockmap.html
[2] https://lore.kernel.org/r/20180808075917.3009181-1-kafai@fb.com
[3] https://man.archlinux.org/man/socket.7#SO_INCOMING_CPU
[4] https://www.freedesktop.org/software/systemd/man/latest/sd_listen_fds.html

Merge pull request #31951 from bluca/resolve_reload

resolved: support reloading configuration at runtime

Merge pull request #31959 from YHNdnzj/execute-pass-fds

core/execute: check if EXEC_PASS_FDS is set if got exec_params.fds

Merge pull request #31960 from YHNdnzj/capsule-followup

Some follow-ups for capsule

dissect: fix memory leak

efi: skip check-alignment-* tests if pefile is not installed

Otherwise, when building with ukify disabled, no one else requires pefile, and
if it is not installed, those tests fail:

```
================================== 12/1212 ===================================
test:         systemd:efi / check-alignment-systemd-bootx64.efi
start time:   14:21:54
duration:     0.08s
result:       exit status 1
command:      /mnt/work/systemd/upstream-fork/main/tools/check-efi-alignment.py /mnt/work/systemd/upstream-fork/main/build/src/boot/efi/systemd-bootx64.efi
----------------------------------- stderr -----------------------------------
Traceback (most recent call last):
  File "/mnt/work/systemd/upstream-fork/main/tools/check-efi-alignment.py", line 7, in <module>
    import pefile
ModuleNotFoundError: No module named 'pefile'
==============================================================================

================================== 13/1212 ===================================
test:         systemd:efi / check-alignment-linuxx64.efi.stub
start time:   14:21:54
duration:     0.08s
result:       exit status 1
command:      /mnt/work/systemd/upstream-fork/main/tools/check-efi-alignment.py /mnt/work/systemd/upstream-fork/main/build/src/boot/efi/linuxx64.efi.stub
----------------------------------- stderr -----------------------------------
Traceback (most recent call last):
  File "/mnt/work/systemd/upstream-fork/main/tools/check-efi-alignment.py", line 7, in <module>
    import pefile
ModuleNotFoundError: No module named 'pefile'
==============================================================================

================================== 14/1212 ===================================
test:         systemd:efi / check-alignment-addonx64.efi.stub
start time:   14:21:54
duration:     0.07s
result:       exit status 1
command:      /mnt/work/systemd/upstream-fork/main/tools/check-efi-alignment.py /mnt/work/systemd/upstream-fork/main/build/src/boot/efi/addonx64.efi.stub
----------------------------------- stderr -----------------------------------
Traceback (most recent call last):
  File "/mnt/work/systemd/upstream-fork/main/tools/check-efi-alignment.py", line 7, in <module>
    import pefile
ModuleNotFoundError: No module named 'pefile'
==============================================================================
```

Follow-up for 7ff3b88396f440bff60328b4bff7627a34d45e4a

hwdb: fix Asus T300FA rotation matrix (#31973)

Closes #31972.

logs-show: read the current boot ID if nothing specified for add_match_boot_id()

No functional change, just refactoring.

sd-id128: move get_boot_id_for_machine() to id128-util.c

And rename it to id128_get_boot_for_machine().

This also splits out id128_get_boot() from sd_id128_get_boot(), and
make id128_get_boot_for_machine() use it.

journalctl-filter: several cleanups for add_matches()

- split it into small pieces to reduce indentation,
- return earlier if no filter specified,
- use journal_add_matchf() and journal_add_match_pair(),
  chase_and_stat(), is_symlink(), and sd_device_new_from_devname(),
- replace sd_device_get_devname() + stat() with sd_device_get_devnum(),
- refuse to install filter by path with --root, --image, or --machine
  at least now, as previously it has not worked anyway.

journalctl-filter: add missing sd_journal_add_conjunction()

Otherwise, if --facility= is specified with extra matches with '+',
the facility filter will not be applied to the specified filter after '+'.

journalctl-filter: several trivial cleanups

- declare iterator in loop,
- use journal_add_match_pair() and journal_add_matchf(),
- log failures in the caller.

journalctl-filter: modernize add_units()

- add missing assertions,
- use set_ensure_consume() and strv_consume(),
- use string_hash_ops_free and _cleanup_set_free_,
- use strv_fnmatch_full(),
- replace unused counter with a boolean flag,
- return earlier if no unit filtering is requested.

Merge pull request #31879 from yuwata/journalctl-split

journalctl: split journalctl.c into small pieces

ndisc-option: sort options in sent message

To make the sent message reproducible.

Merge pull request #31943 from yuwata/sd-ndisc-option-getter-remover

sd-ndisc: introduce option getter and remover

sd-ndisc-protocol: list up all known options

See below for more details:
https://www.iana.org/assignments/icmpv6-parameters/icmpv6-parameters.xhtml#icmpv6-parameters-5

bus-util: dedup bus_set_address_capsule

Follow-up for ad963c3f5680796ccd094b81f35ff7aa20b57247

resolved: support reloading configuration at runtime

Drop connections and caches and reload config from files, to allow
for low-interruptions updates, and hook up to the usual SIGHUP and
ExecReload=. Mark servers and services configured directly via D-Bus
so that they can be kept around, and only the configuration file
settings are dropped and reloaded.

Fixes https://github.com/systemd/systemd/issues/17503
Fixes https://github.com/systemd/systemd/issues/20604

journalctl-show: split out seek_journal()

No functional change, just refactoring.

journalctl: split journalctl.c into small pieces

And introduces per-action functions.
No functional change, just refactoring.

journalctl: use correct type for flags

This also moves its declaration, as it is not changed in the loop.

journalctl: merge three if blocks for seeking to the initial position

No functional change, just refactoring.

systemctl,busctl: sort includes

Follow-up for 56cb74c3cd1358d7d0b3f613feaf2eeab601a6bd
and 00431b2b66cb59540deda4ea018170a289673585

units: sort lists in meson.build

test: use /run/ instead of /etc/ in TEST-75-RESOLVE

daemon-util: introduce notify_reloading helper

Prompted by #31951

Merge pull request #29721 from poettering/systemd-project

New capsule@.service feature

core/execute: check if EXEC_PASS_FDS is set if got exec_params.fds

Prompted by #31789 (specifically
https://github.com/systemd/systemd/pull/31789#discussion_r1525267612)