1
0
mirror of https://github.com/systemd/systemd.git synced 2024-12-22 17:35:35 +03:00

Merge pull request #34328 from poettering/analyze-help-text

analyze: --help text improvements
This commit is contained in:
Lennart Poettering 2024-09-10 06:42:03 +02:00 committed by GitHub
commit 89cdd4866a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -210,44 +210,52 @@ static int help(int argc, char *argv[], void *userdata) {
if (r < 0) if (r < 0)
return log_oom(); return log_oom();
printf("%s [OPTIONS...] COMMAND ...\n\n" printf("%1$s [OPTIONS...] COMMAND ...\n\n"
"%sProfile systemd, show unit dependencies, check unit files.%s\n" "%5$sProfile systemd, show unit dependencies, check unit files.%6$s\n"
"\nCommands:\n" "\n%3$sBoot Analysis:%4$s\n"
" [time] Print time required to boot the machine\n" " [time] Print time required to boot the machine\n"
" blame Print list of running units ordered by\n" " blame Print list of running units ordered by\n"
" time to init\n" " time to init\n"
" critical-chain [UNIT...] Print a tree of the time critical chain\n" " critical-chain [UNIT...] Print a tree of the time critical chain\n"
" of units\n" " of units\n"
"\n%3$sDependency Analysis:%4$s\n"
" plot Output SVG graphic showing service\n" " plot Output SVG graphic showing service\n"
" initialization\n" " initialization\n"
" dot [UNIT...] Output dependency graph in %s format\n" " dot [UNIT...] Output dependency graph in %7$s format\n"
" dump [PATTERN...] Output state serialization of service\n" " dump [PATTERN...] Output state serialization of service\n"
" manager\n" " manager\n"
"\n%3$sConfiguration Files and Search Paths:%4$s\n"
" cat-config NAME|PATH... Show configuration file and drop-ins\n" " cat-config NAME|PATH... Show configuration file and drop-ins\n"
" unit-files List files and symlinks for units\n" " unit-files List files and symlinks for units\n"
" unit-paths List load directories for units\n" " unit-paths List load directories for units\n"
"\n%3$sEnumerate OS Concepts:%4$s\n"
" exit-status [STATUS...] List exit status definitions\n" " exit-status [STATUS...] List exit status definitions\n"
" capability [CAP...] List capability definitions\n" " capability [CAP...] List capability definitions\n"
" syscall-filter [NAME...] List syscalls in seccomp filters\n" " syscall-filter [NAME...] List syscalls in seccomp filters\n"
" filesystems [NAME...] List known filesystems\n" " filesystems [NAME...] List known filesystems\n"
" architectures [NAME...] List known architectures\n" " architectures [NAME...] List known architectures\n"
" smbios11 List strings passed via SMBIOS Type #11\n"
"\n%3$sExpression Evaluation:%4$s\n"
" condition CONDITION... Evaluate conditions and asserts\n" " condition CONDITION... Evaluate conditions and asserts\n"
" compare-versions VERSION1 [OP] VERSION2\n" " compare-versions VERSION1 [OP] VERSION2\n"
" Compare two version strings\n" " Compare two version strings\n"
" verify FILE... Check unit files for correctness\n" " image-policy POLICY... Analyze image policy string\n"
"\n%3$sClock & Time:%4$s\n"
" calendar SPEC... Validate repetitive calendar time\n" " calendar SPEC... Validate repetitive calendar time\n"
" events\n" " events\n"
" timestamp TIMESTAMP... Validate a timestamp\n" " timestamp TIMESTAMP... Validate a timestamp\n"
" timespan SPAN... Validate a time span\n" " timespan SPAN... Validate a time span\n"
"\n%3$sUnit & Service Analysis:%4$s\n"
" verify FILE... Check unit files for correctness\n"
" security [UNIT...] Analyze security of unit\n" " security [UNIT...] Analyze security of unit\n"
" inspect-elf FILE... Parse and print ELF package metadata\n"
" malloc [D-BUS SERVICE...] Dump malloc stats of a D-Bus service\n"
" fdstore SERVICE... Show file descriptor store contents of service\n" " fdstore SERVICE... Show file descriptor store contents of service\n"
" image-policy POLICY... Analyze image policy string\n" " malloc [D-BUS SERVICE...] Dump malloc stats of a D-Bus service\n"
"\n%3$sExecutable Analysis:%4$s\n"
" inspect-elf FILE... Parse and print ELF package metadata\n"
"\n%3$sTPM Operations:%4$s\n"
" pcrs [PCR...] Show TPM2 PCRs and their names\n" " pcrs [PCR...] Show TPM2 PCRs and their names\n"
" srk [>FILE] Write TPM2 SRK (to FILE)\n" " srk [>FILE] Write TPM2 SRK (to FILE)\n"
" smbios11 List strings passed via SMBIOS Type #11\n" "\n%3$sOptions:%4$s\n"
"\nOptions:\n"
" --recursive-errors=MODE Control which units are verified\n" " --recursive-errors=MODE Control which units are verified\n"
" --offline=BOOL Perform a security review on unit file(s)\n" " --offline=BOOL Perform a security review on unit file(s)\n"
" --threshold=N Exit with a non-zero status when overall\n" " --threshold=N Exit with a non-zero status when overall\n"
@ -291,12 +299,14 @@ static int help(int argc, char *argv[], void *userdata) {
" --root=PATH Operate on an alternate filesystem root\n" " --root=PATH Operate on an alternate filesystem root\n"
" --image=PATH Operate on disk image as filesystem root\n" " --image=PATH Operate on disk image as filesystem root\n"
" --image-policy=POLICY Specify disk image dissection policy\n" " --image-policy=POLICY Specify disk image dissection policy\n"
"\nSee the %s for details.\n", "\nSee the %2$s for details.\n",
program_invocation_short_name, program_invocation_short_name,
link,
ansi_underline(),
ansi_normal(),
ansi_highlight(), ansi_highlight(),
ansi_normal(), ansi_normal(),
dot_link, dot_link);
link);
/* When updating this list, including descriptions, apply changes to /* When updating this list, including descriptions, apply changes to
* shell-completion/bash/systemd-analyze and shell-completion/zsh/_systemd-analyze too. */ * shell-completion/bash/systemd-analyze and shell-completion/zsh/_systemd-analyze too. */