summaryrefslogtreecommitdiff
path: root/man
Commit message (Collapse)AuthorAgeFilesLines
* core: drop "const" from NeedsDaemonReload unit dbus propertyLennart Poettering2021-10-121-1/+1
| | | | | | | | | | It's not "const", it can change any time if people change the fs, and we don#t send out notifications for it. Hence don't claim it was const. (Otherwise clients might cache it, but they should not) Prompted-by: #20792 (cherry picked from commit e30a3ba16a5da4b46cd6c8bc363dbccb791fc45e) (cherry picked from commit 3636724012003a2f9b45eb9f8991ae93661de462)
* man: fix a reference in timedatectl man pageAnssi Hannula2021-10-121-2/+3
| | | | | | | | | | | timedatectl(1) says the synchronization service list generation is described "below", but in reality it is documented in systemd-timedated.service(8). Fix the sentence to reference the correct man page. (cherry picked from commit 9376b2aab3692d26de60a93e396f84fa2799b80b) (cherry picked from commit b7c6b9d4a71e38cb5ac33423a9e41a43c833d45e)
* man: Don't leak memory in path-documents exampleThomas Mühlbacher2021-10-121-1/+9
| | | | | | | | | | The `sd_path_lookup(3)` man page states that the returned string shall be `free(3)`'d but then doesn't do so in the example code. Also add basic error handling as well. (cherry picked from commit fee1863c83d04aa06d50a90ff42f5d4f4f2b9178) (cherry picked from commit 010770bbbe45e1c381f4db4f81b35872569a3944)
* man: update description for ManageForeignRoutes=Yu Watanabe2021-09-021-4/+7
| | | | (cherry picked from commit 3fe23a96d66e82ff8b08e6573093e391d62f5bd1)
* network: introduce ManageForeignRoutingPolicyRules= boolean setting in ↵Yu Watanabe2021-09-021-0/+9
| | | | | | | | | | | | | | | networkd.conf The commit 0b81225e5791f660506f7db0ab88078cf296b771 makes that networkd remove all foreign rules except those with "proto kernel". But, in some situation, people may want to manage routing policy rules with other tools, e.g. 'ip' command. To support such the situation, this introduce ManageForeignRoutingPolicyRules= boolean setting. Closes #19106. (cherry picked from commit d94dfe7053d49fa62c4bfc07b7f3fc2227c10aff)
* man: describe veritysetup command syntaxZbigniew Jędrzejewski-Szmek2021-08-061-0/+47
| | | | | | | It makes it easier to diagnose what the generated units actually do. (cherry picked from commit d53285d551d883bb9f097eca0942e8c585e33470) (cherry picked from commit e820d11a409ba93cf1634031fd363dde5e2b6a94)
* man/systemctl: rework descriptions of bind and mount-imageZbigniew Jędrzejewski-Szmek2021-08-061-44/+69
| | | | | | | | | | | | The text used "unit's view" to mean mount namespace. But we talk about mount namespaces in the later part of the paragraph anyway, so trying to use an "approachable term" only makes the whole thing harder to understand. Let's use the precise term. Some paragraph-breaking and re-indentation is done too. (cherry picked from commit e04eae5e1c43c050e0707d3fcfdc16691b761d61) (cherry picked from commit dcdfc4d9a77720d0432d0e587e41e96dc8b8542c)
* man: use title of docs/ pages when referring to themZbigniew Jędrzejewski-Szmek2021-08-065-6/+6
| | | | | | | | | There is some inconsistency, partially caused by the awkward naming of the docs/ pages. But let's be consistent and use the "official" title. If we ever change plural↔singular, we should use the same form everywhere. (cherry picked from commit d6029680df7c4991e37662467668816a83c0b806) (cherry picked from commit 77681242c8c6d7693814b8245e9096e43faa21be)
* man: fix assorted issues reported by the manpage-l10n projectZbigniew Jędrzejewski-Szmek2021-08-0611-46/+49
| | | | | | | | | | Fixes #20297. (cherry picked from commit be0d27ee0c2a2cce39490b8cfc0e7d995fbd7644) (cherry picked from commit 9eb9b07c404be8d59a800c70593809a69f0d0e55) [Only the parts that were conflict-free: I think it's nice to fix errors, but not important enough to devote actual work to it.]
* man: Fix incorrect EFI vendor UUID (last missing nibble)ratijas2021-08-061-1/+1
| | | | | (cherry picked from commit d2e84b601805ae89cf8cb1b383b30c7c97cac73d) (cherry picked from commit 08c99e5600f92c5143b931a507980a2655380cb3)
* man: document nss-{resolve,myhostname} resolving in the other direction, tooFlorian Klink2021-07-232-1/+12
| | | | | (cherry picked from commit 946f7ce32cef44d9bfcf2dc594bb193341434f57) (cherry picked from commit f869a39bceb35406d3193058d6ab5308c2e28f17)
* man: stop recommending putting myhostname after dnsFlorian Klink2021-07-231-10/+6
| | | | | | | | | | | | | | | | | | | nss-resolve also looks in /etc/hosts, and has the same local hostname resolving logic as nss-myhostname. We shouldn't recommend another order than nss-resolve uses internally. When nss-resolve is used, there's no possibility to override nss-myhostname hosts via DNS *anyway*. On top of that, it's not a good idea to allow DNS to override local hostnames as all - at least not something we should advertise in the docs. Followup of f918c67d38ba6ccd4eb0dc657f3f3155e5010cae / https://github.com/systemd/systemd/pull/16754. (cherry picked from commit ce266330fc3bd6767451ac3400336cd9acebe9c1) (cherry picked from commit 21423efc5852194ba3bf2bbc8067258e35c1558d)
* Minor typo (#20254)rene2021-07-201-1/+1
| | | | | | | Correct resoulution with resolution. (cherry picked from commit b838bc11268ea461e8c58ce69e2f781be1821aa1) (cherry picked from commit 5ea3ec8e18a2883c2ea89af9de48fc0fb0e3f283)
* man/systemd.network: Fix duplicate Xfrm descriptionRaul Tambre2021-07-201-8/+0
| | | | | | | It's already listed along with others (Tunnel, VLAN, etc.) and its description matches those. The duplication was introduced by commit c3006a485c9c35c0ab947479ff1dd7149fda9750. (cherry picked from commit 534b5abce12847abc896fba24cafb99c101a2987) (cherry picked from commit d4ce78bfa3d90cc4601d1cbb0b51af32fe8f4b2a)
* Updated manpage for sd_bus_set_propertyBen Stockett2021-07-201-6/+3
| | | | | | | Updated manpage for sd_bus_set_property and sd_bus_set_propertyv. In the old manpage, these functions included the parameter sd_bus_message **reply when the actual function had no such argument. (cherry picked from commit 4226dfafbac2167e1441a7a65d00c29c5016d4fb) (cherry picked from commit 70a318d012d5900ad16685038a1e9a30e9a2a41d)
* Fixed typo (#20187)nassir902021-07-201-2/+2
| | | | | | | | | | | * Fixed typo Before, the file claimed that some systemd units are created "from other configuration". It should have read "from other configuration files". Co-authored-by: Nozz <nozolo90@gmail.com> (cherry picked from commit a814eae728a5e238e39d4a9d952ce8e309fa38fd) (cherry picked from commit 5263490368b3f2c94935300bb5faa09cc04cb4cd)
* docs: improve wording when mentioning the acronym "ESP"nl67202021-07-201-2/+2
| | | | | | | "ESP" is "EFI system partition", so "ESP partition" is redundant. (cherry picked from commit 250db1bf02b9fd73f2e0604acddbc20937c67d19) (cherry picked from commit 6822cfa5f066fcbf79ded85419d59a97decc67b9)
* Clarify the behaviour of suspend-then-sleep mode in the manual pages.Hamish Moffatt2021-07-122-7/+12
| | | | | | Fixes #20125. (cherry picked from commit 33f899bd479534b0a920ce427cdf06739028f5ab)
* man: correct return value of sd_bus_open_with_descriptionLuca Boccassi2021-07-121-2/+5
| | | | | | | | Since https://github.com/systemd/systemd/commit/f4b2933ee7890e5d414ab266d8586f19027a2bd9 if a description is not set, sd_bus_open_with_description returns -ENXIO, but the documnetation stated that it returned successfully with a NULL string. (cherry picked from commit 48e5ef14af5ade97b0f7491c63443778c7602c43)
* oomd: check mem free and swap free before doing a swap-based killAnita Zhang2021-07-121-4/+4
| | | | | https://bugzilla.redhat.com/show_bug.cgi?id=1974763 (cherry picked from commit cb5ce676d96df64fc08a551581489e6e196ea373)
* man/dnssec-trust-anchors: update comment syntax descriptionZbigniew Jędrzejewski-Szmek2021-07-121-7/+5
| | | | | | | Let's just use the same phrase as in systemd.syntax(7). Fixes #20045. (cherry picked from commit 0b497bc46f4599906e153c1613b32fbb4e4f129e)
* resolved: Fix link to resolv.conf manpageRaul Tambre2021-07-121-1/+1
| | | | | | Seems to typically located in volume 5 these days on Linux systems that systemd targets. (cherry picked from commit 12c0bb31a7c20663bf10a2effe498332400de92c)
* man: fix incorrect description regarding DynamicUser= and StateDirectory=dgcampea2021-07-121-7/+6
| | | | (cherry picked from commit e8f4bf33d8a6123ad8ae3955c989e36972f4884d)
* man: update description of "string_escape=" udev optionYu Watanabe2021-07-121-4/+7
| | | | (cherry picked from commit 91c27ac686261fcca913ac6e3fe1520f38440dcb)
* man/50-xdg-data-dirs: add quotes as suggested by shellcheckZbigniew Jędrzejewski-Szmek2021-07-121-2/+2
| | | | (cherry picked from commit aa45911b793255bec34fe8c128c80bda1482cc14)
* Update systemd-resolved.service.8 helpplattrap2021-07-121-1/+1
| | | | | | | Text currently refers to `/etc/nsswitch.conf` where it should refer to `/etc/resolv.conf`. This is in the context of defining a nameserver IP and search domains. (cherry picked from commit e83580bfc6e74359ba242d5176d933ea1e723f89)
* man: fix RFC number and its titleYu Watanabe2021-07-121-2/+2
| | | | (cherry picked from commit f4c48492fe3dfa268b6d2457c9ae425b685ca4e0)
* man: clarify that global search domains apply to global servers, not all ↵Zbigniew Jędrzejewski-Szmek2021-07-121-7/+8
| | | | | | | | interfaces Fixes #19257. (cherry picked from commit dbb3b26f1b347f9d7b9fd56aa4ef4a92253e6f2e)
* man: add note about operation without swap in systemd-oomdAnita Zhang2021-07-121-1/+3
| | | | (cherry picked from commit c48bc311a57aff76b592cc1569ca758b84438ef5)
* man: add missing settingsYu Watanabe2021-07-121-2/+6
| | | | | | Fixes #19869. (cherry picked from commit c3006a485c9c35c0ab947479ff1dd7149fda9750)
* man: merge several settings about netdevYu Watanabe2021-07-091-65/+10
| | | | (cherry picked from commit 85bc4c080d8264c7d7e233c9e0f304c8d650f126)
* man: fix missing markdown & minor errorsPeter Morrow2021-07-091-10/+9
| | | | | | | In #19771 there were a few missing markdown tags a few style issue. Signed-off-by: Peter Morrow <pemorrow@linux.microsoft.com> (cherry picked from commit dbb8b5bcf78a86020287f98a8d96780af0203672)
* man: add details on overriding top level drop-insPeter Morrow2021-07-091-4/+62
| | | | | | | | | When using top level drop-ins it isn't immediately obvious that one can make use of symlinking to disable a top-level drop in for a specific unit. Signed-off-by: Peter Morrow <pemorrow@linux.microsoft.com> (cherry picked from commit 90a404f5d490eb4981851966f6a01f210fd5eb0d)
* man: explain ConditionNeedsUpdate a bit moreZbigniew Jędrzejewski-Szmek2021-07-091-2/+14
| | | | | | | | We were effectively doing all post-upgrade scripts twice in Fedora. We got this wrong, so it's likely other people will get it wrong too. So let's explain what is actually needed to make this work, but also when it's not useful. (cherry picked from commit f75420a43a4dc3c69210f887b38f5df23660ea16)
* man: update docs on systemd-system.conf logging (LogTime=) (#19846)alexlzhu2021-07-092-2/+2
| | | | | | Updating documentation for systemd to reflect that logging is done in the console. (cherry picked from commit 9f40351f77963efc304473830a431c424fd976b1)
* udevadm: fix --tag-match help + descriptionLennart Poettering2021-07-091-1/+1
| | | | (cherry picked from commit d27e6aee5050da17bc9531fb62ac11aba4b15ceb)
* man: fix typoadrian52021-07-091-1/+1
| | | | (cherry picked from commit d0fd114929d3c8d5781e10e408ec178722d2f672)
* tty-ask-password-agent: mention optional argument in helpZbigniew Jędrzejewski-Szmek2021-07-091-4/+4
| | | | | | | | | | | 0cf84693877f060254f04cf38120f52c2aa3059c added --console. 6af621248f2255f9ce50b0bafdde475305dc4e57 added an optional argument, but didn't update the help texts. Note that there is no ambiguity with the optional argument because no positional arguments are allowed. (cherry picked from commit af88c399c0f666abd929b2c906c283731e746458)
* tree-wide: fix typoYu Watanabe2021-07-091-1/+1
| | | | (cherry picked from commit 48008c1cbf932dbdbe25fa88e9c05bf162bcdae8)
* man: document that it is guaranteed that generated ID128 are never all-zero ↵Lennart Poettering2021-07-092-8/+13
| | | | | | | | | | | | or all-one This is the case because the ID128 we generate are all marked as v4 UUID which requires that some bits are zero and others are one. Let's document this so that people can rely on SD_ID128_NULL being a special value for "uninitialized" that is always distinguishable from generated UUIDs. (cherry picked from commit 6f7530929538b28cb41c289ad9cbced51848fc02)
* man: fix list of escaped characters in unit namesLennart Poettering2021-07-091-4/+5
| | | | | | | | | | | | | | The code works differently than the docs, and the code is right here. Fix the doc hence. See VALID_CHARS in unit-name.c for details about allowed chars in unit names, but keep in mind that "-" and "\" are special, since generated by the escaping logic: they are OK to show up in unit names, but need to be escaped when converting foreign strings to unit names to make sure things remain reversible. Fixes: #19623 (cherry picked from commit aa6dc3ec337b04308a5dfe3b962fa88088b2c82e)
* man: document udevadm info output prefixesLennart Poettering2021-07-091-0/+39
| | | | | Fixes: #19663 (cherry picked from commit 205013c8002aacd142264e9b4560e86b0ba05830)
* man: try to clarify that nss-mymachines does not provide name resolution ↵Lennart Poettering2021-07-091-0/+9
| | | | | | | outside its own scope Fixes: #18229 (cherry picked from commit 74c88a25203e7db293ca7a1c31b789e6558129fd)
* man: explicit say for priority/weight values whether more is more or lessLennart Poettering2021-07-092-26/+34
| | | | | Fixes: #17523 (cherry picked from commit 7dbc38db509f153256d3a3bfe6cbb26e2731c741)
* network: allow to set Group=0 in [Link] sectionYu Watanabe2021-07-091-4/+4
| | | | | | | | | Previously, when a link has already in a numbered group, we cannot remove the link from the group. This also fixes the range mentioned in the man page. (cherry picked from commit f0c09831bddb9f335af1b1ebfa6eb8424c2058f3)
* man: we is OK too -> which is OK too (#19708)наб2021-07-091-1/+1
| | | | (cherry picked from commit 8a2f7b7c9b2c8da33d692cc828a99f84e03d018e)
* man: mention that drop-in files are merged in alphanumeric orderYu Watanabe2021-07-094-17/+20
| | | | | | This addresses the request in https://github.com/systemd/systemd/issues/19467#issuecomment-829332877. (cherry picked from commit e6655fbe40a9774c8250c1ae8e1c1677aadb98a6)
* man: document default rlimitsAnita Zhang2021-07-092-1/+18
| | | | | | Fixes #19645 (cherry picked from commit 1539124b394cec0c8d9d67a9ad6dbd00d085bdde)
* man: only the system manager does not pass vars in ManagerEnvironment=Anita Zhang2021-07-091-4/+4
| | | | | | | | | User managers always pass their environment on to their children. Make that clear in the description of ManagerEnvironment= which states that none of those args will get passed to child processes of service managers. (cherry picked from commit c54cfef3968613f9e86e76a3337148360e20150e)
* Fixed a typoei-ke2021-07-091-1/+1
| | | | (cherry picked from commit 410477a78f598e753996e3b7ee40176b219b8379)