1
1
mirror of https://github.com/systemd/systemd-stable.git synced 2025-02-15 05:57:26 +03:00

7478 Commits

Author SHA1 Message Date
Zbigniew Jędrzejewski-Szmek
65bf6c5a8f man: say that ProtectClock= also affects reads
Fixes #26413: the docs said that the filter prevents writes, but it just a
filter at the system call level, and some of those calls are used for writing
and reading. This is confusing esp. when a higher level library call like
ntp_gettime() is denied.

I don't think it's realistic that we'll make the filter smarter in the near
future, so let's change the docs to describe the implementation.

Also, split out the advice part into a separate paragraph.

(cherry picked from commit 42eccfec6e47a5436bd143ee357d2a2da620c2f2)
2023-06-01 16:37:09 +02:00
Zbigniew Jędrzejewski-Szmek
13c8807360 man: fixes for assorted issues reported by the manpage-l10n project
Fixes #26761.

(cherry picked from commit 8fb350049bb7a7305589f201df9d37482e544f24)
2023-06-01 16:37:09 +02:00
Lennart Poettering
29115ef32e man: indicate that the JOB parameter to "systemctl cancel" is optional
As per:

https://social.treehouse.systems/@grawity/110376583742207755
(cherry picked from commit 7e0aaeb244dafd7a3ff69295b8ea60e827fe2f21)
2023-06-01 16:37:09 +02:00
nikstur
85ba46539f man: use correct name for --bank option
(cherry picked from commit 916db27f16a8ef897e5a1de09aa9289143908980)
2023-06-01 16:37:09 +02:00
Miao Wang
32831842ba doc: remove legacy DefaultControlGroup from dbus properties
DefaultControlGroup does not exist any more.

(cherry picked from commit 4fad639a1350b1ce2fa77249f8e81dcc4229ee57)
2023-05-12 10:04:45 +02:00
Yu Watanabe
cd795f9abc udev-rules: fix negative match rule for SYMLINK and TAG
Fixes #27396.

(cherry picked from commit 2b43ab00b08a052fc0077dd20f111c474730ad52)
2023-04-30 20:11:33 +01:00
Vitaly Kuznetsov
b1ecfe3fe7 man: /usr/lib/systemd/random-seed -> /usr/lib/systemd/systemd-random-seed
/usr/lib/systemd/random-seed is not a thing.

Signed-off-by: Vitaly Kuznetsov <vkuznets@redhat.com>
(cherry picked from commit b4e5c103be9de99dfb5e2e47fd1563cf5388978a)
2023-04-27 21:30:38 +01:00
Luca Boccassi
59243061f6 man: fix LogControl1 manpage example
Follow-up for c6b8fffdfaf1f7c9a1dac73e1e54993a06c766c0

(cherry picked from commit 33054db730fb6f2fd6221d38a788e30b95525463)
2023-04-27 21:30:38 +01:00
Luca Boccassi
5a8987794e man: clarify sd_bus_default
It picks the bus based on the cgroup slice.

(cherry picked from commit f0f7cbd488fd0e00c5b77baf3b1324240fd7d72d)
2023-04-27 21:30:38 +01:00
Luca Boccassi
b9af9a320e man: add working example to LogControl1 manpage
Add fully working and documented example that can be copied and pasted

(cherry picked from commit c6b8fffdfaf1f7c9a1dac73e1e54993a06c766c0)
2023-04-27 21:30:38 +01:00
Lennart Poettering
5ff63b8507 man: try to make clearer that /var/ is generally not available in /usr/lib/systemd/system-shutdown/ callouts
I made the mistake to look into what is installed into
/usr/lib/systemd/system-shutdown/ on Fedora. fwdupd among other things
assumes /var/ is available from these callouts, though it is not in the
general case.

Hence, let's emphasize this in the documentation a bit more.

(cherry picked from commit e002b8a28acc24e0a29cdc3f6cf759a197203f4a)
2023-04-27 21:30:38 +01:00
Florian Klink
3ee1839c19 fsck: look for fsck binary not just in /sbin
This removes remaining hardcoded occurences of `/sbin/fsck`, and instead
uses `find_executable` to find `fsck`.

We also use `fsck_exists_for_fstype` to check for the `fsck.*`
executable, which also checks in `$PATH`, so it's fair to assume fsck
itself is also available.

(cherry picked from commit a108fcbacee859036f5613177321889bc34fd597)
2023-04-27 21:30:38 +01:00
ZjYwMj
f86ec34958 Synposis and description of networkctl man page reflecting only part of its functionality (#27264)
* Fix inaccurate synposis, and description

Before the fix, they reflected only part of networkctl functionality.

(cherry picked from commit dd9f909ea819a4a06218982f681b92dab0ba7d9d)
2023-04-27 21:30:38 +01:00
Franklin Yu
430861fc96 Fix cross-reference of manual for LogsDirectory
(cherry picked from commit 8dacdd28f49e0b985d651e7c9f946aa666454063)
2023-04-27 21:30:38 +01:00
Michal Sekletar
1fb4ae32b0 man: add util-linux to the package list for Fedora container
/bin/login is shipped in util-linux, however, systemd.spec on Fedora has
"Requires: (util-linux-core or util-linux)". If the dependency is
fulfilled just by installation of util-linux-core then users won't be
able to log in into the container after it boots. Let's add util-linux
package to the package list so that /bin/login is always present.

(cherry picked from commit 5015b5014bcff93371aef2c78b92efcfc2e38a40)
2023-04-27 21:30:38 +01:00
Zbigniew Jędrzejewski-Szmek
841146f243 man: link to Fedora 37
Fedora 36 is a bit old at this point and will be EOL in about 6 weeks.
Fedora 38 is not out yet, so the cloud link wouldn't work.

(cherry picked from commit 5a9e2dff473fe9c18f1425fd18ed7c16881b6997)
2023-04-27 21:30:38 +01:00
Uwe Kleine-König
6179141124 man/systemd-mount: Clearify documentation about --bind-device
The documentation suggests that the mount point (i.e. the directory
where the device is mounted) is removed when the device vanishes.
However only stopping of the automount unit is implemented.

So adapt the documentation to reality.

(cherry picked from commit 381ccb424643acd8bf99e5db16ad96b64996e4e9)
2023-04-27 21:30:38 +01:00
Sorah Fukumori
16dc17d68c man: netdev: Clarify wireguard IPv6 endpoint format
(cherry picked from commit 744b04c5571eb1518e686dce505357aa3fb94ce8)
2023-04-27 21:30:38 +01:00
Yu Watanabe
018461aaf0 man: mention -o option for systemd-journal-remote
(cherry picked from commit bc729e81f2622961ef8428df46bb000197706f70)
2023-04-27 21:30:38 +01:00
Zbigniew Jędrzejewski-Szmek
0430078cfb man: restore description of ConditionControlGroupController=v1|v2
We use ConditionControlGroupController=v2 in systemd-oomd.service, and also
this condition makes sense in general, so it should be documented.

This reverts a part of 6d48c7cf736ced70c1c2fef1e1f03618911d04bc.

Deprecated commandline options and v1 controller names were removed from
the description.

(cherry picked from commit c32f496b9e7326584e49ae478539c4bc5c51ebe1)
2023-04-27 21:30:38 +01:00
Luca Boccassi
8b1cc644c5 man: add example for sd_bus_call_method
(cherry picked from commit ce199d12e9a88286271dec6f22cd2c61f1cd7f54)
2023-04-27 21:30:38 +01:00
Luca Boccassi
382e53977c man: further shorten print-unit-path example
(cherry picked from commit d10a5f6c3de64fcaa71855d9a94394ea8317038a)
2023-04-27 21:30:38 +01:00
Lennart Poettering
960f05945c man: link up new online coredump docs from man page
(cherry picked from commit bba6046b241c0e073a6f70ef1f418434c72d3161)
2023-04-27 21:30:38 +01:00
Luca Boccassi
18afac6e90 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 a5979f0bd50234ff9cad47f160d121628e0e3bbe)
2023-04-27 21:30:38 +01:00
Lennart Poettering
a2ef3c97bd 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 75f7e5e54704e643aa9b50ce03ed02a49e75333f)
2023-03-29 16:56:51 +02:00
Frantisek Sumsal
5d2588b594 man: s/io.systemd.Dropin/io.systemd.DropIn/
(cherry picked from commit 8f572d0d82f2f8bb3995faa569da5af1ef7a427d)
2023-03-29 16:56:51 +02:00
Antonio Alvarez Feijoo
2a8c1168b1 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 9baeb58fcdcd3b8893fc485bb33726820ce46e94)
2023-03-29 16:56:51 +02:00
Mike Yuan
fd963d1bc8 sleep: fix default values unmatched with manual
(cherry picked from commit f05b4bb9a7a70092641f43486fc7a45c85fc9c63)
2023-03-29 16:56:51 +02:00
Addison Snelling
37f65e46d3 man: fix misspelled executable name (#26858)
(cherry picked from commit 0c868e3fada33c7139112f0268c29307bdcd6ee7)
2023-03-29 16:26:39 +02:00
Zbigniew Jędrzejewski-Szmek
2ead535f0d 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 7b3693e4e4c9cae50fca65136278a62fae11327e.

(cherry picked from commit 449172f943acadc7fd1e2293a615c7cb0d87fcd6)
2023-03-29 16:26:39 +02:00
Daan De Meyer
16183e66f6 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 80c7d4b8fa9f8283af7f0213739e3463c68a30f6)
2023-03-29 16:26:39 +02:00
Morten Linderud
67ba5637c0 man: Fix pcrphase.service manvolnum from 1 to 8
(cherry picked from commit 9e60dc0daffdb3c8b137c9ec529d7942e1c52124)
2023-03-29 16:11:41 +02:00
Jeidnx
d527eee9cd man: fix typo in ukify page
(cherry picked from commit 2208d9662313e90f4aa8d24f1573b8fbcd97120a)
2023-03-29 16:05:45 +02:00
Zbigniew Jędrzejewski-Szmek
4b12a1cf92 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 695e39dd632801871b4e96b39bc8e7511083a34e)
2023-03-28 18:59:01 +02:00
Zbigniew Jędrzejewski-Szmek
6bef1f0085 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 dca031d2290311d8670d34fd758397644796e114)
2023-03-28 18:58:59 +02:00
Zbigniew Jędrzejewski-Szmek
2a31faf625 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 396d298d6b0c50a3ab3242392de43dd50df6d45f)
2023-03-28 18:58:58 +02:00
Zbigniew Jędrzejewski-Szmek
da8c0e0978 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 253d0d591bdca605c9a775e22407f9ae80003234)
2023-03-28 18:58:57 +02:00
Zbigniew Jędrzejewski-Szmek
c7afeee1e6 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 87291a26f5262c47bdb3493d15534c18f25870e6)
2023-03-28 18:58:55 +02:00
Yu Watanabe
b8b20dc261 man: mention systemd-growfs-root.service
(cherry picked from commit 61ccf030aef82e335941260b82381d0056b475c7)
2023-03-28 18:57:59 +02:00
Yu Watanabe
20f71ba98f man: mention systemd-fsck-usr.service
(cherry picked from commit 5e9750533586efa3d480ac2bc4cf8549993bc3f1)
2023-03-28 18:57:58 +02:00
Jan Engelhardt
c181761f9a doc: correct wrong use "'s" contractions
(cherry picked from commit 18fe76eba59dc494597b07e0114899b69f92cc12)
2023-03-28 18:57:49 +02:00
Lennart Poettering
dc98d58dd8 man: add two missing commands to synopsys
(cherry picked from commit aff131775b002ddac74b1c65d849dcd52a02c06d)
2023-03-03 10:30:56 +01:00
Zbigniew Jędrzejewski-Szmek
aac692160e 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 164297cd9a410fdd9ca3c068da4d80d74916cf18)
2023-03-03 10:06:11 +01:00
Mike Yuan
c4cdbb978f 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 db4691961ca52759fe6645d0fddb659ee4299ac2)
2023-03-03 09:57:28 +01:00
Yu Watanabe
fff1edc9f9
Merge pull request #26424 from ldv-alt/fix-typos
Fix a few typos in NEWS, docs and comments
2023-02-16 00:10:18 +09:00
Raul Tambre
6b4dc4d2f8 man/tc: Fix hexadecimals being with an O 2023-02-15 16:03:28 +01:00
Dmitry V. Levin
30fd9a2dab treewide: fix a few typos in NEWS, docs and comments 2023-02-15 10:41:03 +00:00
ml
6ebfecd073 man: fix typos 2023-02-12 00:54:07 +01:00
ml
f39d7d00a3 man: fix directory for user home bind mounts 2023-02-12 00:48:25 +01:00
Zbigniew Jędrzejewski-Szmek
f37f0f35cd man: fix links to man pages
Done using linkchecker as usual.
2023-02-09 14:30:43 +01:00