1
1
mirror of https://github.com/systemd/systemd-stable.git synced 2025-01-10 01:17:44 +03:00
Commit Graph

7188 Commits

Author SHA1 Message Date
Luca Boccassi
75ee851a41 man: add example for sd_bus_call_method
(cherry picked from commit ce199d12e9)
(cherry picked from commit 8b1cc644c5)
2023-04-28 16:29:56 +01:00
Luca Boccassi
16aee50c2b man: further shorten print-unit-path example
(cherry picked from commit d10a5f6c3d)
(cherry picked from commit 382e53977c)
2023-04-28 16:29:56 +01:00
Lennart Poettering
14a5056e5c man: link up new online coredump docs from man page
(cherry picked from commit bba6046b24)
(cherry picked from commit 960f05945c)
2023-04-28 16:29:56 +01:00
Luca Boccassi
cde5615a44 man: fix shellcheck warning for html.in
SC2015: Note that A && B || C is not if-then-else. C may run when A is true.
(cherry picked from commit a5979f0bd5)
(cherry picked from commit 18afac6e90)
2023-04-28 16:29:56 +01:00
Lennart Poettering
34e83c24a7 man: correct/tweak text about unit name syntax
Unit names can be 255 characters long, not 256.

We first say "name prefix" and then continue with "unit prefix".
Confusing. Couldn't figure out which term is better hence settled on
"unit name prefix".

(cherry picked from commit 75f7e5e547)
(cherry picked from commit a2ef3c97bd)
2023-03-30 19:21:34 +02:00
Frantisek Sumsal
50a9e9a5b0 man: s/io.systemd.Dropin/io.systemd.DropIn/
(cherry picked from commit 8f572d0d82)
(cherry picked from commit 5d2588b594)
2023-03-30 19:21:34 +02:00
Antonio Alvarez Feijoo
357a3f1d2b man/network-generator: replace dracut.kernel reference with dracut.cmdline
`dracut.kernel.7` is just a symlink to `dracut.cmdline.7`, so the web reference
points to a non-existent URL
(https://man7.org/linux/man-pages/man7/dracut.kernel.7.html).

(cherry picked from commit 9baeb58fcd)
(cherry picked from commit 2a8c1168b1)
2023-03-30 19:08:14 +02:00
Mike Yuan
9ced8895e1 sleep: fix default values unmatched with manual
(cherry picked from commit f05b4bb9a7)
(cherry picked from commit fd963d1bc8)
2023-03-30 19:06:09 +02:00
Addison Snelling
8a711f1c26 man: fix misspelled executable name (#26858)
(cherry picked from commit 0c868e3fad)
(cherry picked from commit 37f65e46d3)
2023-03-30 19:06:04 +02:00
Zbigniew Jędrzejewski-Szmek
df2ff69d16 man: document "Delegate=" a bit more
This case is a bit surprising, even if logical if one understands how the
parser works. Let's be more explicit.

Follow-up for 7b3693e4e4.

(cherry picked from commit 449172f943)
(cherry picked from commit 2ead535f0d)
2023-03-30 19:05:40 +02:00
Daan De Meyer
56c4a34fa0 man: Fix user generator output paths
These are all under $XDG_RUNTIME_DIR/systemd instead of directly
under $XDG_RUNTIME_DIR.

(cherry picked from commit 80c7d4b8fa)
(cherry picked from commit 16183e66f6)
2023-03-30 19:02:40 +02:00
Morten Linderud
b1b266b79f man: Fix pcrphase.service manvolnum from 1 to 8
(cherry picked from commit 9e60dc0daf)
(cherry picked from commit 67ba5637c0)
2023-03-30 19:02:20 +02:00
Zbigniew Jędrzejewski-Szmek
f4764ea126 man: adjust description of CPUAccounting=
For any user on a semi-recent kernel, effectively this setting is pointless.
We should deprecate it once not needed anymore for the v1 hierarchy. For
now, adjust the description.

(cherry picked from commit 695e39dd63)
(cherry picked from commit 4b12a1cf92)
2023-03-30 19:01:08 +02:00
Zbigniew Jędrzejewski-Szmek
52e2479bd6 man: add a note about session autogrouping
When cpu controller is disabled, thing would often still behave as if
it was. And since the cpu controller can be enabled "magically" e.g. by
starting user@1000, add a note for users to be careful. Autogrouping
is described well in the man page, incl. how to enable or disable it,
so it should be enough to refer to that.

(cherry picked from commit dca031d229)
(cherry picked from commit 6bef1f0085)
2023-03-30 19:01:07 +02:00
Zbigniew Jędrzejewski-Szmek
97ecc1c6b3 man: tweak details in descriptions of pids and cpu configuration
For CPUWeight=: there is an important distinction between our default of
[not set], and the kernel default of "100". Let's not say that our default
is "100" because then 'systemctl show' output is hard to explain.

For task accounting, it's the kernel that does the accounting, not systemd.

(cherry picked from commit 396d298d6b)
(cherry picked from commit 2a31faf625)
2023-03-30 19:01:06 +02:00
Zbigniew Jędrzejewski-Szmek
7646f29a84 man: describe how cgroup controllers are turned on
For a user, information which cgroup controllers are enabled based on
the unit configuration is rather important. Not only because it determines
what resource control is peformed by the kernel, but also because controllers
have a non-negligible cost, especially for deep nesting, and users may want
to *not* have controllers enabled.

Our documentation did its best to avoid the topic so far. This was partially
caused by the support for cgroup v1, which meant that any discussion of
controllers had to be conditional and messy. But v1 is deprecated on its way
out, so it should be fine to just describe what happens with v2.

The text is extended with a discussion of how controllers are enabled and
disabled, and an example, and for various settings that enable controllers
the relevant controller is now mentioned.

(cherry picked from commit 253d0d591b)
(cherry picked from commit da8c0e0978)
2023-03-30 19:00:55 +02:00
Zbigniew Jędrzejewski-Szmek
1114a7a522 man: explain route-only domains a bit more
The details discussion of how search and route-only domains work is in
systemd-resolved.service(8). But users are more likely to look at
resolved.conf(5), because that's where Domains= is described. So let's add a
reference to the other man page there, and also strengthen the text a bit. In
particular, in systemd-resolved.service(8) we say "route-only", which makes
the distinction with search domains clearer. Let's use the same in the other
man page too.

This is based on feedback from Lukáš Nykrýn that the man page is not clear
enough.

(cherry picked from commit 87291a26f5)
(cherry picked from commit c7afeee1e6)
2023-03-30 19:00:22 +02:00
Yu Watanabe
0e29ec09dd man: mention systemd-growfs-root.service
(cherry picked from commit 61ccf030ae)
(cherry picked from commit b8b20dc261)
2023-03-30 19:00:03 +02:00
Yu Watanabe
720cb50229 man: mention systemd-fsck-usr.service
(cherry picked from commit 5e97505335)
(cherry picked from commit 20f71ba98f)
2023-03-30 19:00:02 +02:00
Jan Engelhardt
08cffef584 doc: correct wrong use "'s" contractions
(cherry picked from commit 18fe76eba5)
(cherry picked from commit c181761f9a)
2023-03-30 18:59:55 +02:00
Lennart Poettering
7d3af1ff11 man: add two missing commands to synopsys
(cherry picked from commit aff131775b)
(cherry picked from commit dc98d58dd8)
2023-03-03 12:00:36 +01:00
Zbigniew Jędrzejewski-Szmek
e72f1676af man/tmpfiles.d: adjust the table in synopsis, improve spelling
r and R take globs, so let's name the argument appropriately in the tl;dr listing.

Also, use 'clean-up' in the file name where it represents the verb "clean up",
and other minor spelling adjustments.

(cherry picked from commit 164297cd9a)
(cherry picked from commit aac692160e)
2023-03-03 11:58:46 +01:00
Mike Yuan
e9889190be journalctl: fix output when --lines is used with --grep
Previously, we skip the entries before arg_lines
unconditionally, which doesn't behave correctly
when used with --grep. After this commit, when
a pattern is specified, we don't skip the entries
early, but rely on the count of the lines shown
to tell us when to stop. To achieve that we would
have to search backwards instead.

Fixes #25147

(cherry picked from commit db4691961c)
(cherry picked from commit c4cdbb978f)
2023-03-03 11:37:00 +01:00
ml
bfaf02348e man: fix directory for user home bind mounts
(cherry picked from commit f39d7d00a3)
2023-02-16 00:46:43 +00:00
Zbigniew Jędrzejewski-Szmek
9ad732e70c man: fix links to man pages
Done using linkchecker as usual.

(cherry picked from commit f37f0f35cd)
2023-02-10 20:28:11 +00:00
Zbigniew Jędrzejewski-Szmek
ebada36b7b man: fix section number
Fixes #26376.

(cherry picked from commit 359c14368e)
2023-02-10 20:28:11 +00:00
Luca Boccassi
f0126ad7f9 core: imply DeviceAllow=/dev/tpmrm0 with LoadCredentialEncrypted
If the device access policy is restricted, add implicitly access to the TPM
if at least one encrypted credential needs to be loaded.

Fixes https://github.com/systemd/systemd/issues/26042

(cherry picked from commit 398dc7d39b)
2023-02-10 20:28:11 +00:00
Lennart Poettering
2d495affef pcrphase: gracefully exit if TPM2 support is incomplete
If everything points to the fact that TPM2 should work, but then the
driver fails to initialize we should handle this gracefully and not
cause failing services all over the place.

Fixes: #25700
(cherry picked from commit 0318d54539)
2023-02-10 20:28:11 +00:00
Yu Watanabe
eea08d150c sleep: introduce SuspendEstimationSec=
Before v252, HibernateDelaySec= specifies the maximum timespan that the
system in suspend state, and the system hibernate after the timespan.

However, after 96d662fa4c, the setting is
repurposed as the default interval to measure battery charge level and
estimate the battery discharging late. And if the system has enough
battery capacity, then the system will stay in suspend state and not
hibernate even if the time passed. See issue #25269.

To keep the backward compatibility, let's introduce another setting
SuspendEstimationSec= for controlling the interval to measure
battery charge level, and make HibernateDelaySec= work as of v251.

This also drops implementation details from the man page.

Fixes #25269.

(cherry picked from commit 4f58b656d9)
2023-02-10 17:00:49 +01:00
David Tardon
25e30725d7 mount: handle bind mount of file with non-existing target
When the target (Where=) of a mount does not exist, systemd tries to
create it. But previously, it'd always been created as a directory. That
doesn't work if one wants to bind-mount a file to a target that doesn't
exist.

Fixes: #17184
(cherry picked from commit 218cfe2335)
2023-01-26 09:12:21 +01:00
Zbigniew Jędrzejewski-Szmek
5183d46ba1 core,man: add missing integration of OOMPolicy= in scopes
Fixup for 5fa098357e.

(cherry picked from commit d5a1657d5a)
2023-01-23 11:51:12 +01:00
Mark Laws
d539e18777 systemd: Support OOMPolicy in scope units
Closes #25376.

(cherry picked from commit 5fa098357e)
2023-01-23 11:51:12 +01:00
Yu Watanabe
1c8abb343a man: mention that DefaultRouteOnDevice= create the IPv4 default route
And add an example setting for creating an IPv6 default route.

Closes #25440.

(cherry picked from commit 15f330cf87)
2022-12-08 23:00:35 +01:00
Neil Moore
0ba8e9ecff virt: Support detection of LMHS SRE guests
(cherry picked from commit d833ed781f)
2022-12-08 21:29:56 +01:00
Zbigniew Jędrzejewski-Szmek
dbed9051f7 man: add note that network-generator is not a generator
Also fix indentation.

(cherry picked from commit 2fa6574e83)
2022-11-08 14:59:01 +01:00
Daan De Meyer
1757446e8b condition: Check that subsystem is enabled in ConditionSecurity=tpm2
Instead of succeeding when either the firmware reports a TPM device
or we find a TPM device, let's check that the firmware reports a TPM
device and the TPM subsystem is enabled in the kernel.

To check whether the subsystem enabled, we check if the relevant
subdirectory in /sys exists at all.

(cherry picked from commit 300bba79c2)
2022-11-07 13:16:26 +00:00
Frantisek Sumsal
35e19c1a50 man: use the correct 'Markers' property name for marking units
Follow-up to c9615f7352 and 70666e28a1.

(cherry picked from commit 1ca1bb03de)
2022-11-04 23:31:28 +00:00
Luca Boccassi
8aaa4e05a3 man: fix typo found by Lintian
(cherry picked from commit 84033dd405)
2022-11-04 23:31:28 +00:00
Lennart Poettering
5bdf35c14e man: make clear NNP has no effect on processes invoked through systemd-run/at/crontab and such things 2022-10-31 12:53:52 +01:00
Jan Janssen
6e50cf38a6 NEWS: Clarify overlapping UKI PE section offsets 2022-10-31 11:08:13 +01:00
Steve Ramage
1d87f03a6e
man: Add documentation for AssertCredential= (#25178)
Fixes #25177.

Co-authored-by: Steve Ramage <gitcommits@sjrx.net>
2022-10-30 06:07:21 +09:00
Nick Rosbrook
6dfaeac370 man: document reboot --poweroff exception
When reboot is invoked, the -p/--poweroff option is intentionally
ignored. Update the man page to reflect this exception.
2022-10-29 06:39:32 +09:00
Yu Watanabe
7db98bc938 network: make RouteTable= also accept route table name 2022-10-28 11:35:17 +09:00
Zbigniew Jędrzejewski-Szmek
7155a51e64
Merge pull request #25146 from keszybz/relicese-to-mit-0
Change license of code examples in docs to MIT-0
2022-10-27 07:31:56 +02:00
Zbigniew Jędrzejewski-Szmek
1fe6d37ea5 man: change license of examples to MIT-0
Quoting Richard Fontana in [1]:

  CC0 has been listed by Fedora as a 'good' license for code and content
  (corresponding to allowed and allowed-content under the new system). We plan
  to classify CC0 as allowed-content only, so that CC0 would no longer be
  allowed for code.

  Over a long period of time a consensus has been building in FOSS that
  licenses that preclude any form of patent licensing or patent forbearance
  cannot be considered FOSS. CC0 has a clause that says: "No trademark or
  patent rights held by Affirmer are waived, abandoned, surrendered, licensed
  or otherwise affected by this document." (The trademark side of that clause
  is nonproblematic from a FOSS licensing norms standpoint.) The regular
  Creative Commons licenses have similar clauses.

For the case of our documentation snippets, patent issues do not matter much.
But it is always nicer to have a license that is considerred acceptable without
any further considerations. So let's change the license to the (now recommended
replacement) MIT-0.

[1] https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/message/NO7KGDNL5GX3KCB7T3XTGFA3QPSUJA6R/

Using 'git blame -b' and 'git log -p --follow', I identified the following
folks as having made non-trivial changes to those snippets:

  Lennart Poettering
  Tom Gundersen
  Luca Bocassi
  Zbigniew Jędrzejewski-Szmek
  Thomas Mühlbacher
  Daan De Meyer

I'll ask for confirmation in the pull request.
2022-10-26 08:39:34 +02:00
Lennart Poettering
2781f7b43b man: also use DDIs in systemd-dissect man page 2022-10-25 18:59:10 +02:00
Daan De Meyer
bb6a971cca man: Mention that journal file size is capped to 4G in compact mode 2022-10-25 21:23:01 +09:00
Yu Watanabe
8207ec4b49
Merge pull request #25080 from keszybz/search-paths
Refusing linking files underneath our hierarchy, improve error messages
2022-10-25 01:57:41 +09:00
Zbigniew Jędrzejewski-Szmek
32d2e70ae4 man: fix count mismatch
We said "search path" and "search paths" in the same sentence…
2022-10-24 12:54:03 +02:00
Luca Boccassi
701f7f6c8f
Merge pull request #25077 from keszybz/completions-optional-components
Fix completions when machinectl is not installed and other fixes
2022-10-20 15:57:46 +02:00