bus-wait-for-units: rearrange function

bus-wait-for-units: correctly report state if disconnected from bus

bus-wait-for-units: rephrase error message

bus-wait-for-units: use hashmap_remove_value where appropriate

bus-wait-for-jobs: remove unneeded strna and refactor code a bit

bus-wait-for-jobs: a few modernizations

bus-wait-for-jobs: rephrase error message

bus-wait-for-jobs: reorganize functions

bus-wait-for-jobs: sort includes

Merge pull request #30656 from mrc0mmand/dfuzzer-shenanigans

test: avoid starting/stopping unwanted units during fuzzing

resolve: DnsTransaction.scope may be NULL when dns_transaction_close_connection() is called

Follow-up for ac1b7b9e1933c14bc7bf36d4f32a888afb3f2f4d.

Fixes CID#1533020.

resolve: add several comments for DNS type table

Also update compile time checks.

Follow-up for 818bb6f4825b57c2cd2783fbffe2b2ef82a31573.

Merge pull request #30658 from jnohlgard/udevadm-lock-return-code

udevadm: Propagate return code from verb result

test: add simple coverage tests for 'udevadm lock'

udevadm: Propagate return code from verb result

udevadm lock did not propagate the return code from the child process
because all positive values were treated as success.

v2:
Now 'udevadm test-builtin' ignores all positive return values from the
builtin commands. Otherwise, as the hwdb builtin returns an positive value
when a matching entry found, 'udevadm test-builtin hwdb' will fail.

v3:
Initialize partition table before calling 'sfdisk --delete'.

Co-authored-by: Yu Watanabe <watanabe.yu+github@gmail.com>

test: show journal entries matching the test's syslog identifier as well

test: avoid starting/stopping unwanted units during fuzzing

Skip calling start and stop methods on unit objects, as doing that is
not only time consuming, but it also starts/stops units that interfere
with the machine state. The actual code paths should be covered (to some
degree) by the respective method counterparts on the manager object.

fd-util: don't eat up errors in fd_cloexec_many

Follow-up for ed18c22c989495aab36512f03449222cfcf79aa7

Before this commit, a successful fd_cloexec() call would
discard all previously gathered errors.

test: wrap adding a suppression in a method

sd-journal: check sd-event state before setting up post change timer

The similar check already exists in schedule_post_change().

The function is currently called at two places.
- journal_file_open() in sd-journal:
  In this case, if the timer is not set up, then journal_file_post_change()
  will be called at the end of journal_file_append_entry(). So, the necessary
  task will be done sequentially when an journal entry is stored to the opened
  journal file. That is desired when the function is called at outside of the
  event loop.
- server_open_journal() in journald:
  This is not called after we exit the event loop.

So, we can safely do nothing in the function if the event loop is being
finished or already finished.

Fixes #30644.

coccinelle: re-indent comments

coccinelle: fix typo

Follow-up for b25d3b36a21cd7a68039b85f887cc849ff7664a1.

dns: update record type enum to match iana

Adds some new dns record types. Also, some types were inserted into the
middle of the enum — this corrects an error where the enum constants for
some of the record types previously held an incorrect value.

Merge pull request #30649 from YHNdnzj/close-nointr-unnecessary

Some modernization/cleanup for fd-util

units: add ConditionSecurity=tpm2 to systemd-tpm2-setup units

ConditionSecurity=measured-uki can be true even with TPM 1.2 which we
don't support, so add an explicit check for TPM 2.0.

Fixes https://github.com/systemd/systemd/issues/30650

Follow-up for 2e64cb71b9c0160c3

po: Translated using Weblate (Punjabi)

Currently translated at 26.4% (60 of 227 strings)

Co-authored-by: A S Alam <aalam@users.noreply.translate.fedoraproject.org>
Translate-URL: https://translate.fedoraproject.org/projects/systemd/master/pa/
Translation: systemd/main

various: don't use close_nointr if retval is not checked anyway

logind-session-device: use _cleanup_close_

shared/async: use safe_close where appropriate

fdset: use FOREACH_ARRAY at one more place

fd-util: modernization

machinectl: add `restart` convenience alias (#30625)

network/address: unconditionally check if address is ready

Previously, we checked if the address is ready only when it is an IPv6
address. But, IPv4 address never enter tentative state, hence the check
for an IPv4 address is effectively equivalent to the one for IPv6.
So, let's unify the check. This does not change any effective behavior.

Merge pull request #30643 from bluca/completion

bash completion additions for systemctl/systemd-analyze

Merge pull request #30641 from YHNdnzj/hibernation-device

Follow-ups for hibernate-util

Merge pull request #30634 from dtardon/docbook-valid-3

DocBook validation fixes (part 3)

bash completion: add systemd-analyze architectures

Follow-up for fb8cc599ed863502d67

analyze: allow --no-legend with architectures verb

It prints a table with a header, allow omitting it

Follow-up for fb8cc599ed863502d67

bash completion: make systemctl mount-image/bind autocomplete on active services

The verb works only on running service units, so complete on that as the first
parameter, and a local file as the second. The other parameters are inside the
service namespace so we can't autocomplete from the outside, return early.

bash completion: add systemctl service-log-level/target

sleep: don't log duplicate error

write_resume_config() logs error on its own.

hibernate-util: remove unused code

All callers of write_resume_config() pass non-NULL device.

hibernate-util: make sure we use blockdev path for HibernationDevice.path

Before this commit, this field could spuriously contain the path of the
swapfile.

Merge pull request #30639 from mrc0mmand/more-cocci-shenanigans

Another batch of Coccinelle tweaks

tpm2-util: declare the cleanup attribute first

As we do everywhere else (apart from it being incosistent, the switched
order also makes Coccinelle unhappy).

bootctl: add a missing space

test: use timestamp_is_set()

test: use set_isempty() in one more place

test: use IN_SET()/ERRNO_IS_NEG_*() more

tree-wide: use IN_SET() more

coccinelle: dial back warnings about performance

Turns out I _really_ underestimated the impact of
--include-headers-for-types, as it significantly reduces both runtime
and storage penalties. For example, on my machine the runtime of
uncached run goes down from ~15 minutes to ~2 minutes, and similarly the
total storage needed by the cache goes from ~15 GiB down to ~3 GiB.

coccinelle: help Coccinelle with some more complex macros

Drop the original macro file, since it's not needed anymore thanks to
resolving includes properly, but introduce a similar file -
parsing_hacks.h - that helps Coccinelle in some specific corner cases.

This eliminates most of the outstanding parsing errors in source files.
The remaining ones are limitations of the parsing engine (see the FIXMEs
in pasing_hacks.h) and need further investigation.

coccinelle: search the system include path for header files as well

Since Coccinelle is originally a kernel tool, it doesn't search the
system include path by default for header files. Without this we're
missing a lot of types provides by stdlib (and other libraries we make
use of).

Merge pull request #30631 from yuwata/network-address-free

network/address: tiny cleanups for address_free()

sleep: connect to correct bus when locking homed-managed homes

Partially reverts 122f6f1eaa4447449c7054793f6497eb9e4d03c6

Fixes https://github.com/systemd/systemd/issues/29938#issuecomment-1869508708

man: rewrite as <group>

man: fix markup

<arg> is not allowed inside <title>.

man: move </variablelist> to the right place

man: fix <cmdsynopsis> content

Inline text is not allowed.

man: fix markup

<option> is not allowed in <cmdsynopsis>.

man: restrict <command> to the actual command

man: move macro decls. out of <funcsynopsis>

<funcsynopsis> doesn't allow block content.

man: fix markup

<arg> is not allowed inside <term>.

coccinelle: explicitly undefine SD_BOOT

So Coccinelle doesn't pull in includes guarded by #if SD_BOOT.

For example:

$ head -n5 main.c
 #if FOO
 #include "foo.h"
 #else
 #include "bar.h"
 #endif

$ spatch --verbose-includes --recursive-includes --sp-file zz-drop-braces.cocci main.c
init_defs_builtins: /usr/lib64/coccinelle/standard.h
HANDLING: main.c
including ./foo.h
including ./bar.h

$ spatch --verbose-includes --recursive-includes --sp-file zz-drop-braces.cocci main.c --undefined FOO
init_defs_builtins: /usr/lib64/coccinelle/standard.h
HANDLING: main.c
including ./bar.h

man: fix indentation

coccinelle: fix typo

hwdb: Add override for headset form-factor for the Corsair Void Elite

Earlier versions of the headset had 'Headset' in the product name.
This version uses 'Dongle' instead, so it doesn't get given a form-factor.

Merge pull request #30633 from mrc0mmand/cocci-shenanigans

coccinelle: rework how we run the Coccinelle transformations

systemctl: use SYNTHETIC_ERRNO()

modules-load: simplify OOM check

sd-bus: drop unnecessary braces

network: use timestamp_is_set() in one more place

tree-wide: use strndupa_safe() in a couple more cases

nspawn: log & return in a single statement

tree-wide: use IOVEC_MAKE() in a couple more places

test: use FLAGS_SET() in one more place

test: use ERRNO_IS_NEG_NOT_SUPPORTED() in one more place

killall: fix errno check

network: ENOTSUP -> EOPNOTSUPP

tree-wide: shorten a couple of ternary expressions

tree-wide: drop !! casts to booleans

man: add required <title>

man: match doctype and root element

man: use same version in public and system ident.

core/unit: don't log 0 values in unit_log_resources

Prompted by #30573

network: use RET_GATHER() macro

coccinelle: properly drop braces around single-statement if()s

coccinelle: fix the log-json rule

As it generated very questionable results.

coccinelle: rework how we run the Coccinelle transformations

Turns out that the original way we did things was quite broken, as it
skipped a _lot_ of code. This was because we just threw everything into
one pile and tried to spatch it, but this made Coccinelle sad, like when
man page examples redefined some of our macros, causing typedef
conflicts.

For example, with a minimal reproducer that defines a cleanup macro in
two source files, Coccinelle has no issues when spatch-ing each one
separately:

$ spatch --verbose-parsing --sp-file zz-drop-braces.cocci main.c
init_defs_builtins: /usr/lib64/coccinelle/standard.h
HANDLING: main.c
SPECIAL NAMES: adding _cleanup_ as a attribute with arguments
SPECIAL NAMES: adding _cleanup_free_ as a attribute

$ spatch --verbose-parsing --sp-file zz-drop-braces.cocci
logcontrol-example.c
init_defs_builtins: /usr/lib64/coccinelle/standard.h
HANDLING: logcontrol-example.c
SPECIAL NAMES: adding _cleanup_ as a attribute with arguments

But when you try to spatch both of them at once, Coccinelle starts
complaining and skipping the "bad" code:

$ spatch --verbose-parsing --sp-file zz-drop-braces.cocci main.c logcontrol-example.c
init_defs_builtins: /usr/lib64/coccinelle/standard.h
HANDLING: main.c logcontrol-example.c
SPECIAL NAMES: adding _cleanup_ as a attribute with arguments
SPECIAL NAMES: adding _cleanup_free_ as a attribute
remapping: _cleanup_ to an ident in macro name
ERROR-RECOV: found sync end of #define, line 44
parsing pass2: try again
ERROR-RECOV: found sync end of #define, line 44
parse error
 = File "logcontrol-example.c", line 44, column 21, charpos = 1719
  around = '__attribute__',
  whole content = #define _cleanup_(f) __attribute__((cleanup(f)))
badcount: 2
bad: #include <systemd/sd-journal.h>
bad:
BAD:!!!!! #define _cleanup_(f) __attribute__((cleanup(f)))

This was, unfortunately, hidden as it is visible only with
--verbose-parsing (or --parse-error-msg).

Another issue was how we handled includes. The original way of throwing
them into the pile of source files doesn't really work, leading up to
similar issues as above. The better way is to let Coccinelle properly
resolve all includes by telling it where to find our own include files
(basically the same thing we already do during compilation).

After fixing all this, Coccinelle now has a chance to process much more
of our code (there are still some issues in more complex macros, but
that requires further investigation). However, there's a huge downside
from all of this - doing a _proper_ code analysis is surprisingly time
and resource heavy; meaning that processing just one Coccinelle rule now
takes 15 - 30 minutes.

To make this slightly less painful, Coccinelle supports caching the
generated ASTs, which actually helps a lot - it gets the runtime of one
rule from 15 - 30 minutes down to ~1 minute. It, of course, has its own
downside - the cache is _really_ big (ATTOW the cache takes ~15 GiB).

However, even with the aggressive AST caching you're still looking at
~1 hour for one full Coccinelle run, which is a bit annoying, but I
guess that's the price of doing things _properly_ (but I'll definitely
look into ways of further optimizing this).

network/address: move post-processes on address removal to address_drop()

For consistency with other follow-up processes after address removal.

No functional change, just refactoring and preparation for later
commits.

network/address: also drop reference for DHCP server address

The Address object should never freed after it is referenced.
So, this should not change any behavior. Just for safety.

various: use FOREACH_ARRAY more

Prompted by #30622

Merge pull request #30628 from YHNdnzj/format-table-improvement

Some improvements for format-table

Merge pull request #30616 from dtardon/docbook-valid-2

DocBook validation fixes (part 2)

Merge pull request #30607 from dtardon/docbook-improvements

Minor improvements to man pages

Merge pull request #30622 from yuwata/space

tree-wide: drop unnecessary space or insert missing space

man: use <refsect1> instead of <refsection>

DocBook document model doesn't allow mixing of <refsection> with the
numbered variants (<refsect1> etc.). Therefore, any document that
included something from standard-conf.xml was invalid. Fortunately, all
the includes are at the 1st level, hence let's just change
standard-conf.xml to use <refsect1> to fix that.

core,format-table: use strna/ersatz for formatting fdstore dump

Currently, the code doesn't handle anonymous inodes correctly.

format-table: introduce table_isempty and use it where appropriate

man: drop an extra <member>

Follow-up for 13a69c120bc584e90f863f821710b3b5294cd206 .