summaryrefslogtreecommitdiffstats
path: root/man (follow)
Commit message (Collapse)AuthorAgeFilesLines
* Typo fix in man/systemd.resource-controlSuhailAhmedVelorum3 days1-1/+1
|
* man: split systemd.conf(5) into multiple sectionsLennart Poettering4 days1-217/+244
| | | | | | No changes in wording, let's just make a very long man page a bit more digestable by adding sections, and then reordering settings to fit into them.
* ukify: Switch to JSON HWID description format (#35208)Zbigniew Jędrzejewski-Szmek4 days2-0/+39
|\ | | | | Fixes #35176
| * man: Document ukify --hwids= and --devicetree-auto= optionsanonymix0079 days2-0/+39
| |
* | man: several more assorted fixesYu Watanabe5 days5-7/+15
| | | | | | | | | | Continuation of 4ebbb5bfe88ac3d793c395472648660c33251546. Closes #35307.
* | man/systemd-system.conf: Correct "struct" to "strict" (#35364)Winterhuman5 days1-1/+1
| |
* | Revert "Revert "man: use MIT-0 license for example codes in daemon(7)""Yu Watanabe5 days1-0/+9
| | | | | | | | This reverts commit 7a9d0abe4df81a020e2e457405f8509b2afb7c04.
* | Revert "man: use MIT-0 license for example codes in daemon(7)"Luca Boccassi5 days1-9/+0
| | | | | | | | This reverts commit 6046cc3660810efcc6fe50b1c850ea642218245b.
* | man: use MIT-0 license for example codes in daemon(7)Yu Watanabe5 days1-0/+9
| | | | | | | | | | | | | | This page contains many short example codes. I do not think we should add SPDX-License-Identifier for all codes. Closes #35356.
* | man: update documentation about basic .netdev file handlingYu Watanabe8 days1-4/+10
| | | | | | | | Follow-up for #34909 and later PRs.
* | man: asorted fixesYu Watanabe8 days44-149/+190
| | | | | | | | Closes #35307.
* | man: add enrollment type sections to cryptenroll man pageLennart Poettering9 days1-23/+64
|/ | | | | We have the same sections in the --help text, hence we even more so should have them in the man page.
* man/kernel-command-line: fix typoAntonio Alvarez Feijoo12 days1-1/+1
|
* man: fix copy-and-paste errorYu Watanabe13 days1-3/+3
| | | | Follow-up for 85a1360ecffd8929151e09279ea62dedea364dfa.
* man: add several future version info tagsYu Watanabe13 days1-0/+3
|
* man/network: update documentation for KeepConfiguration=Yu Watanabe2024-11-141-14/+14
|
* sbsign: remove unused --no-pager optionAntonio Alvarez Feijoo2024-11-121-1/+0
|
* Fix man page links broken due to incorrect volume numbers (#35122)Yu Watanabe2024-11-1227-51/+51
|\
| * man/systemd.special: fix a typoŠtěpán Němec2024-11-111-1/+1
| |
| * man: fix incorrect volume numbers in internal man page referencesŠtěpán Němec2024-11-1127-50/+50
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Some ambiguity (e.g., same-named man pages in multiple volumes) makes it impossible to fully automate this, but the following Python snippet (run inside the man/ directory of the systemd repo) helped to generate the sed command lines (which were subsequently manually reviewed, run and the false positives reverted): from pathlib import Path import lxml from lxml import etree as ET man2vol: dict[str, str] = {} man2citerefs: dict[str, list] = {} for file in Path(".").glob("*.xml"): tree = ET.parse(file, lxml.etree.XMLParser(recover=True)) meta = tree.find("refmeta") if meta is not None: title = meta.findtext("refentrytitle") if title is not None: vol = meta.findtext("manvolnum") if vol is not None: man2vol[title] = vol citerefs = list(tree.iter("citerefentry")) if citerefs: man2citerefs[title] = citerefs for man, refs in man2citerefs.items(): for ref in refs: title = ref.findtext("refentrytitle") if title is not None: has = ref.findtext("manvolnum") try: should_have = man2vol[title] except KeyError: # Non-systemd man page reference? Ignore. continue if has != should_have: print( f"sed -i '\\|<citerefentry><refentrytitle>{title}" f"</refentrytitle><manvolnum>{has}</manvolnum>" f"</citerefentry>|s|<manvolnum>{has}</manvolnum>|" f"<manvolnum>{should_have}</manvolnum>|' {man}.xml" )
* | man/systemd-keyutil: fix rendering typoAntonio Alvarez Feijoo2024-11-121-1/+1
|/
* Introduce systemd-keyutil to do various key/certificate operations (#35095)Lennart Poettering2024-11-114-26/+106
|\ | | | | | | | | | | | | Let's gather generic key/certificate operations in a new tool systemd-keyutil instead of spreading them across various special purpose tools. Fixes #35087
| * Introduce systemd-keyutil to do various key/certificate operationsDaan De Meyer2024-11-084-26/+106
| | | | | | | | | | | | | | | | Let's gather generic key/certificate operations in a new tool systemd-keyutil instead of spreading them across various special purpose tools. Fixes #35087
* | News and f41 and formatting (#35078)Zbigniew Jędrzejewski-Szmek2024-11-0844-147/+148
|\ \ | |/ |/|
| * man: drop whitespace from final <programlisting> linesZbigniew Jędrzejewski-Szmek2024-11-0843-144/+145
| | | | | | | | | | | | In the troff output, this doesn't seem to make any difference. But in the html output, the whitespace is sometimes preserved, creating an additional gap before the following content. Drop it everywhere to avoid this.
| * man: update Fedora links to F41Zbigniew Jędrzejewski-Szmek2024-11-072-3/+3
| |
* | ukify: Introduce --certificate-provider= optionDaan De Meyer2024-11-071-0/+11
| | | | | | | | | | This translates to --certificate-source=provider:<provider> for signing tools invoked by ukify.
* | measure: Add pcrpkey verbDaan De Meyer2024-11-071-0/+10
| | | | | | | | | | | | | | | | This verb writes a public key to stdout extracted from either a public key path, from a certificate (path or provider) or from a private key (path, engine, provider). We'll use this in ukify to get rid of the use of the python cryptography module to convert a private key or certificate to a public key.
* | tree-wide: Introduce --certificate-source= optionDaan De Meyer2024-11-074-15/+41
|/ | | | | | | This allows loading the X.509 certificate from an OpenSSL provider instead of a file system path. This allows loading certficates directly from hardware tokens instead of having to export them to a file on disk first.
* man: fix typos flagged by LintianLuca Boccassi2024-11-072-2/+2
|
* man: run update-man-rulesLuca Boccassi2024-11-061-0/+1
|
* man: fix syntax error in systemd-sbsign.xmlLuca Boccassi2024-11-061-1/+1
| | | | Follow-up for 5f163921e9ff6d735798db259c47543822f81b5c
* Introduce systemd-sbsign to do secure boot signing (#35021)Daan De Meyer2024-11-062-14/+138
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Currently in mkosi and ukify we use sbsigntools to do secure boot signing. This has multiple issues: - sbsigntools is practically unmaintained, sbvarsign is completely broken with the latest gnu-efi when built without -fshort-wchar and upstream has completely ignored my bug report about this. - sbsigntools only supports openssl engines and not the new providers API. - sbsigntools doesn't allow us to cache hardware token pins in the kernel keyring like we do nowadays when we sign stuff ourselves in systemd-repart or systemd-measure There are alternative tools like sbctl and pesign but these do not support caching hardware token pins in the kernel keyring either. To get around the issues with sbsigntools, let's introduce our own tool systemd-sbsign to do secure boot signing. This allows us to take advantage of our own openssl infra so that hardware token pins are cached in the kernel keyring as expected and we get openssl provider support as well.
| * ukify: Add --signing-provider= optionDaan De Meyer2024-11-061-11/+24
| |
| * ukify: Add support for systemd-sbsignDaan De Meyer2024-11-061-3/+3
| |
| * sbsign: Add validate-key verbDaan De Meyer2024-11-061-0/+16
| | | | | | | | This verb checks that we can load the specified private key.
| * Introduce systemd-sbsign to do secure boot signingDaan De Meyer2024-11-061-0/+95
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Currently in mkosi and ukify we use sbsigntools to do secure boot signing. This has multiple issues: - sbsigntools is practically unmaintained, sbvarsign is completely broken with the latest gnu-efi when built without -fshort-wchar and upstream has completely ignored my bug report about this. - sbsigntools only supports openssl engines and not the new providers API. - sbsigntools doesn't allow us to cache hardware token pins in the kernel keyring like we do nowadays when we sign stuff ourselves in systemd-repart or systemd-measure There are alternative tools like sbctl and pesign but these do not support caching hardware token pins in the kernel keyring either. To get around the issues with sbsigntools, let's introduce our own tool systemd-sbsign to do secure boot signing. This allows us to take advantage of our own openssl infra so that hardware token pins are cached in the kernel keyring as expected and we get openssl provider support as well.
* | networkd: add possibility to specify MulticastIGMPVersionMichele Dionisio2024-11-061-0/+21
| |
* | tree-wide: use Device*T*ree spellingZbigniew Jędrzejewski-Szmek2024-11-062-2/+2
| | | | | | | | | | | | | | | | We used both, in fact "Devicetree" was more common. But we have a general rule that we capitalize all words in names and also we have a DeviceTree= configuration setting, which we cannot change. If we use two different spelllings, this will make it harder for people to use the correct one in config files. So use the "DeviceTree" spelling everywhere.
* | man/systemd-stub: rework the description of sectionsZbigniew Jędrzejewski-Szmek2024-11-061-34/+42
| | | | | | | | | | | | | | | | The text added for .dtbauto/.hwids was very hard to grok. This rewords it to be proper English. No semantic changes are intended. When updating this, I noticed that the interaction of multi-profile UKIs and dtb autoselection is very unclear, a FIXME is added.
* | man/varlink: fix typoYu Watanabe2024-11-061-1/+1
| | | | | | | | Follow-up for 4f5fabe7a39f046e0456eba07472df061e85c94e.
* | man/udev: fix typoYu Watanabe2024-11-061-1/+1
| | | | | | | | Follow-up for df8f9b88bd41320653fe1c51ea515a2d03a349df.
* | man/systemd-measure: add forgotten "="Zbigniew Jędrzejewski-Szmek2024-11-061-1/+1
| | | | | | | | | | | | Both syntaxes work, but let's use one syntax for consistency. Fixup for 0641ce809a27cc1bc358924c26770f19d1213ec1.
* | man/systemd-measure: update to new ukify syntax, non-root operationZbigniew Jędrzejewski-Szmek2024-11-061-8/+14
| | | | | | | | | | It's been a while, but systemd-measure doesn't need root, and ukify has a more modern syntax.
* | UKI: Introduce `.dtbauto` sections (#34855)Lennart Poettering2024-11-062-2/+18
|\ \ | | | | | | Split out from #34158
| * | man: Document stub behaviour for .hwids and .dtbauto sectionsanonymix0072024-11-051-0/+14
| | |
| * | measure: Introduce .dtbauto supportanonymix0072024-11-051-2/+3
| | |
| * | measure: introduce support for a .hwids sectionanonymix0072024-11-051-2/+3
| |/
* | man: convert multiple left-over "See Also" sections to <simplelist>Lennart Poettering2024-11-0519-75/+79
| | | | | | | | | | | | | | These were forgotten during the initial conversion, probably because most of them consisted only of a single entry. Fix that.
* | man: link up D-Bus API docs from daemon man pagesLennart Poettering2024-11-0525-15/+153
| | | | | | | | | | | | | | | | | | | | Let's systematically make sure that we link up the D-Bus interfaces from the daemon man pages once in prose and once in short form at the bottom ("See Also"), for all daemons. Also, add reverse links at the bottom of the D-Bus API docs. Fixes: #34996