Commit Graph
7247 Commits
Author SHA1 Message Date
Zbigniew Jędrzejewski-Szmek ecb4685783 Another batch of conversions to COMMAND and additions of --introspect-cli (#43406) 2026-08-17 16:40:49 +02:00
Zbigniew Jędrzejewski-Szmek f2194e053f test: also exercise the "help" verb of introspectable commands
Verb-based commands register the help verb with
VERB_COMMON_HELP_AUTO("name"), where the name is spelled separately from
the one used for --help, so let's check that it works too.
2026-08-17 16:11:09 +02:00
Zbigniew Jędrzejewski-Szmek d32d25847d userdbctl: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added.
2026-08-17 16:11:09 +02:00
Zbigniew Jędrzejewski-Szmek 71f974a1eb ssh-issue: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The abstract is reworded to be a more
regular sentence.
2026-08-17 16:10:56 +02:00
Zbigniew Jędrzejewski-Szmek 4a32b1cbf1 sleep: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek 6e19fb74bf sbsign: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The abstract gains its missing trailing
period and says "PE binaries", like the man page.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek ef3bb712a7 report: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. --help now goes through the pager, like other
commands with --no-pager.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek 2b875c24c9 random-seed: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek d1137e3cb1 portablectl: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The "(default)" suffix is dropped from the
help text of the "list" verb, since the default verb is now shown in
brackets in the Commands: table anyway.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek 24fb06f158 oomctl: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek 1ad1a47472 networkctl: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. --help now goes through the pager, like other
commands with --no-pager.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek de3bd5c46d localectl: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. --help now goes through the pager, like other
commands with --no-pager.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek 618aa83e18 keyutil: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek 2908468b39 importctl: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The abstract gains its missing trailing
period.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek 63ac493274 hostnamectl: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek 655cfb24af factory-reset: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The abstract is reworded to "Query, request,
or cancel a factory reset operation."
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek 7485176ea1 cryptsetup: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek e6858b9b31 creds: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The abstract loses its odd capitalization
("Display and process credentials."). --help now goes through the pager,
like other commands with --no-pager.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek 6f63f2074e coredumpctl: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. --help now goes through the pager, like other
commands with --no-pager.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek d927ccf38a busctl: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. Verb and option column widths are kept
separate via COMMAND_HELP_SEPARATE, since the verb table is very wide,
as before.
2026-08-17 15:49:01 +02:00
Zbigniew Jędrzejewski-Szmek 8f53e3ac89 bless-boot: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added.
2026-08-17 13:32:25 +02:00
Zbigniew Jędrzejewski-Szmek fb4a092b9a test: check that systemd-clonesetup's verbs are described by --introspect-cli
Same as for systemd-hwdb and systemd-id128.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 9cf35bfa4d validatefs: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The positional argument is spelled MOUNTPOINT
in the synopsis, like the other metavars, instead of /path/to/mountpoint,
and the man page synopsis, which said "[DEVICE]", is fixed to match: the
argument is required and it is a mount point.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 760bd23cec update-done: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 3e7b76f672 tpm2-setup: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 9f402dcce5 tpm2-clear: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The man page reference is fixed to
systemd-tpm2-clear.service(8), the only name that page is known by.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 2805c192f9 sysinstall: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The abstract is changed to use the imperative
form ("Install …" instead of "Installs …"), consistent with the other
commands. This also fixes the doubled colon in the "Options::" heading.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek e70f197e37 storagetm: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek de4804f0da systemd-storage-fs: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The abstract is changed from the noun phrase
"Simple file system backed storage provider" to the imperative "Expose
regular files and directories as storage volumes.", following the man
page and consistent with the other commands.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek eb6297012d systemd-storage-block: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The abstract is changed from the noun phrase
"Simple block device backed storage provider" to the imperative "Expose
local block devices as storage volumes.", following the man page and
consistent with the other commands.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 67f17eb4c8 stdio-bridge: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. --help now also references the man page,
which the old help did not.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 3b9dd1ea53 socket-proxyd: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The synopsis no longer marks the target as
optional, since exactly one HOST:PORT or SOCKET argument is required.
The hint about systemd.time(7) is kept as the footer.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek d1c345a079 pcrextend: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The man page is adjusted to match.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 4df2325694 networkd-wait-online: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 9da7b27037 network-generator: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The old help had neither an abstract nor a
man page reference; both are added, with the abstract taken from the
man page.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek c590744048 modules-load: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The abstract is changed to use the imperative
form ("Load …" instead of "Loads …"), consistent with the other
commands.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 7125bf3ac4 journal-upload: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The synopsis now marks the input files as
optional, since the local journal is read when none are given, and
--url= as optional, since URL= may come from journal-upload.conf,
matching the man page.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 9cea0873a0 journal-remote: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The synopsis now marks the input files as
optional, since input may also come from --url=, --getter=, --listen-*=
or passed file descriptors, matching the man page. The note about
sd_listen_fds() is kept as the footer.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 6e64a169bd journal-gatewayd: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The abstract is changed from the noun phrase
"HTTP server for journal events." to the imperative "Serve journal events
over HTTP.", consistent with the other commands, and the meaningless
"..." placeholder is dropped from the synopsis (the tool takes no
positional arguments).
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 031ff861a6 hibernate-resume: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. --clear, which takes no positional
arguments, is listed as a separate synopsis line.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 0e313315bf growfs: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The positional argument is spelled MOUNTPOINT
in the synopsis, like the other metavars, instead of /path/to/mountpoint.
The man page is adjusted to match.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek fca21f54d7 clonesetup: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added. The two hand-written synopsis lines are
replaced by the generic one, and --help now lists the verbs in a
Commands: section generated from the verb table.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek ec964d79cb boot-check-no-failures: convert to VERB_COMMAND and add --introspect-cli
The custom help() is replaced by a COMMAND() description, and
--introspect-cli is added.
2026-08-17 13:21:31 +02:00
Zbigniew Jędrzejewski-Szmek 494701162f TEST-74-AUX-UTILS.introspect-cli: verify that --help works
This is redundant for public programs, for which we test --help
more extensively, but is also good as a basic check that e.g. the
program name used to print help matches what is specified in COMMAND.
2026-08-17 13:21:17 +02:00
Paul Meyer 8444646969 test: report subtest skips (#43387)
`run_subtests` now handle exit 77 as skip status, making successful
subtests distinguishable from passed tests. Introduce
`run_subtests_and_exit` as a helper to automatically write `/testok` if
all subtests passed, and to write `/skipped` and exit 77 if all subtests
were skipped.
2026-08-17 11:44:56 +02:00
Yu Watanabe 30c177a937 test-network: add test cases for IPv6ProxyNDP=no
In that case, IPv6 proxy neighbor entries are ignored.

This also checks IPv6ProxyNDP=yes is implied if an IPv6 proxy neighbor
address is specified.
2026-08-17 17:19:09 +09:00
Yu Watanabe a9e74be13c network: adjust sysctl setting in network_adjust_neighbor_proxy()
This also makes IPv4 proxy neighbor entries independent of proxy_arp
sysctl. We can configure IPv4 proxy neighbor entries even if proxy_arp
is disabled.
2026-08-17 17:17:18 +09:00
Yu Watanabe 78ca255140 network: do not touch proxy_ndp sysctl when nothing requested
Even though the document says "When unset, the kernel's default will
be used." for IPv6ProxyNDP=, previously, when both IPv6ProxyNDP= and
IPv6ProxyNDPAddress= are unspecified, proxy_ndp sysctl was disabled.
This was also inconsistent to other sysctl settings.
2026-08-17 17:15:22 +09:00
Yu Watanabe 80922ebbc5 network: unify IPv4ProxyARPAddress= and IPv6ProxyNDPAddress=
It is not necessary to provide dedicated settings for IPv4 and IPv6
proxy neighbor entries. Let's unify them.

The IPv4ProxyARPAddress= setting was introduced after v261. Hence, we
can freely rename it.
2026-08-17 16:58:03 +09:00
Clayton Craft d52a693164 test: cover both of timesyncd's resolver paths
This checks that we resolve through resolved when it's running, and fall back
to getaddrinfo when it isn't.
2026-08-15 13:12:50 -07:00