Zbigniew Jędrzejewski-Szmek
6c83ea9eda
This adds the helpers to add a hidden --introspect-cli option which prints a machine-readable description of the program's interface and exits. Applicable to any programs that have been converted to VERB_COMMAND(). The output format follows the draft CLI-Introspection Specification (https://github.com/behrmann/uapi-specifications/blob/cli-introspection/specs/cli_introspection.md): a single JSON document with a fixed "mediaType" string and an array of command objects, one per VERB_COMMAND() defined in the binary, so multicall binaries are described in full. Options are taken from the command's option namespace, so e.g. systemd-dissect does not list the mount.ddi mount-helper options. $ build/systemd-id128 --json=pretty --introspect-cli { "mediaType" : "application/vnd.io.systemd.cli-introspection-0", "commands" : [ { "names" : [ "systemd-id128" ], "version" : "262~devel", "features" : [ "-PAM", ... ], "abstract" : [ "Generate and print 128-bit identifiers." ], "options" : [ { "names" : [ "-h", "--help" ], "argument" : "no_argument", "help" : "Show this help" }, ... ], "verbs" : [ { "names" : [ "new" ], "abstract" : [ "Generate a new ID" ], "maxArguments" : 1 }, ... ] } ] } $ build/systemd-id128 --introspect-cli | jq '.commands[0].options[].names[-1]' "--help" "--version" "--no-pager" "--no-legend" "--json" "-j" "--pretty" "--value" "--app-specific" "--uuid" "--introspect-cli"
System and Service Manager
Details
Most documentation is available on systemd's website.
Assorted, older, general information about systemd can be found in the systemd Wiki.
Information about build requirements is provided in the README file.
Consult our NEWS file for information about what's new in the most recent systemd versions.
Please see the Code Map for information about this repository's layout and content.
Please see the Hacking guide for information on how to hack on systemd and test your modifications.
Please see our Contribution Guidelines for more information about filing GitHub Issues and posting GitHub Pull Requests.
When preparing patches for systemd, please follow our Coding Style Guidelines.
If you are looking for support, please contact our mailing list, join our IRC channel #systemd on libera.chat or Matrix channel
Stable branches with backported patches are available in the stable repo.
We have a security bug bounty program sponsored by the Sovereign Tech Fund hosted on YesWeHack
Repositories with distribution packages built from git main are available on OBS, and also repositories with packages built from the latest stable release