1
1
mirror of https://github.com/systemd/systemd-stable.git synced 2025-02-01 05:47:04 +03:00

6912 Commits

Author SHA1 Message Date
Zbigniew Jędrzejewski-Szmek
e4983ef9d0 man: extend description of --boot
(cherry picked from commit a3256ea8f4684ff92622ca9df1dc18dc517a4c6e)
(cherry picked from commit 286ce2be44422e53347edd8f79acd5532b96780c)
(cherry picked from commit 5cfc6e18b794c647bd238cd358d292573cc6f99b)
2023-06-02 22:45:46 +01:00
Mike Yuan
55d0253aba Revert (partially) "man: Clarify when OnFailure= activates after restarts (#7646)"
This reverts part of commit bd2538b50ba283c9ce39142d5d16d90184a55b90,
specifically changes to the description of service state between auto-restarts.

Fixes #27594

(cherry picked from commit 2200cf47ce7e0f049bcda156a897565f45233838)
(cherry picked from commit e85daabd3ebf06add790c00d19b1df5bdd7b9e4b)
(cherry picked from commit 3d00dba68ea2dba44f73035e5b45f85cec1cb542)
2023-06-02 22:45:46 +01:00
Zbigniew Jędrzejewski-Szmek
02d6de716e man/tmpfiles: fix off-by-one in example
Reported and diagnosed by gitterman. Fixes #26617.

(cherry picked from commit f90360eb7417e083650034ad819790df0c389bd1)
(cherry picked from commit 3e286a7b2e1a97ff71282cd78087a3a7f43a53f0)
(cherry picked from commit cb511894bdf38d2bad2ecf6609b3748bd89ff67b)
2023-06-02 22:45:46 +01:00
Zbigniew Jędrzejewski-Szmek
bc8ac5b42c man: explain allowed values for /sys/power/{disk,state}
Also fix the grammar: "neither" can only be used with two values, and
here we have an inderminate number >= 1.

Fixes #26460.

(cherry picked from commit 2f76f1cfaee2f775df8b367cb77aed751af45956)
(cherry picked from commit cb6641bde3d2d8d236c4eccf16172a77d6295d5f)
(cherry picked from commit fdac06ec81a48a7a79181bd4935cf3fb35c9f430)
2023-06-02 22:45:46 +01:00
Zbigniew Jędrzejewski-Szmek
dec29d01a2 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)
(cherry picked from commit 65bf6c5a8f16448528af674cc381fd05fcc6c338)
(cherry picked from commit 54652191b4e7c5ce886378e6821d310b7ca4741d)
2023-06-02 22:45:46 +01:00
Lennart Poettering
db4e9c5b8f man: indicate that the JOB parameter to "systemctl cancel" is optional
As per:

https://social.treehouse.systems/@grawity/110376583742207755
(cherry picked from commit 7e0aaeb244dafd7a3ff69295b8ea60e827fe2f21)
(cherry picked from commit 29115ef32e5c4e1a89c80ec2cdfcff5190e70e8f)
(cherry picked from commit 0086c49546fd84460c3acc9e50dd25d4a64fc5ad)
2023-06-02 22:45:46 +01:00
Miao Wang
a4835f0977 doc: remove legacy DefaultControlGroup from dbus properties
DefaultControlGroup does not exist any more.

(cherry picked from commit 4fad639a1350b1ce2fa77249f8e81dcc4229ee57)
(cherry picked from commit 32831842bade4d91ff00cf2bbbb12008dd55f835)
(cherry picked from commit e63041299b5f2a3933638b43cfacf3559638baa1)
2023-06-02 22:45:46 +01:00
Vitaly Kuznetsov
783885a98a 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)
(cherry picked from commit b1ecfe3fe7a74b2be8127dfa15514cd9f01f5c85)
(cherry picked from commit 1e8057fce7dfd5c826f066a9b456dd403bea37a2)
2023-04-29 11:36:49 +01:00
Luca Boccassi
f12531d653 man: fix LogControl1 manpage example
Follow-up for c6b8fffdfaf1f7c9a1dac73e1e54993a06c766c0

(cherry picked from commit 33054db730fb6f2fd6221d38a788e30b95525463)
(cherry picked from commit 59243061f62142ee0f74d25e352a55f174f1bb97)
(cherry picked from commit 7bcdbf43011f7b1c72a552f126924795a15baf30)
2023-04-29 11:36:49 +01:00
Luca Boccassi
b1f2d0da63 man: clarify sd_bus_default
It picks the bus based on the cgroup slice.

(cherry picked from commit f0f7cbd488fd0e00c5b77baf3b1324240fd7d72d)
(cherry picked from commit 5a8987794eb1cddf43bfe240d241d3a5462c1e5a)
(cherry picked from commit a9e44da6b1a2c15f24d26b94970a384432745d00)
2023-04-29 11:36:49 +01:00
Luca Boccassi
ce99445126 man: add working example to LogControl1 manpage
Add fully working and documented example that can be copied and pasted

(cherry picked from commit c6b8fffdfaf1f7c9a1dac73e1e54993a06c766c0)
(cherry picked from commit b9af9a320ece89804ba8e17390240e4325968ef5)
(cherry picked from commit 3c9b9aabc53e12f8fd9804556ccdab6205518aa8)
2023-04-29 11:36:49 +01:00
ZjYwMj
491530f2e7 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)
(cherry picked from commit f86ec3495853ab143d5b0c1d0cb09b5725ef8d40)
(cherry picked from commit ef395963a4f89af2ee19caaf5e05206f1040cfe1)
2023-04-29 11:36:49 +01:00
Franklin Yu
468acc7264 Fix cross-reference of manual for LogsDirectory
(cherry picked from commit 8dacdd28f49e0b985d651e7c9f946aa666454063)
(cherry picked from commit 430861fc96585c6a5913b2a84456916e516a1a44)
(cherry picked from commit 696c0ed616dcd549903321db024d6ad7aad3ceca)
2023-04-29 11:36:49 +01:00
Michal Sekletar
6c1046121d 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)
(cherry picked from commit 1fb4ae32b08c737662714c259573159d0e8788c3)
(cherry picked from commit 7c353ca5d60c57324ba9163528603311864f22d5)
2023-04-29 11:36:49 +01:00
Zbigniew Jędrzejewski-Szmek
ab287e91bf 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)
(cherry picked from commit 841146f243db0c368b20b111fe5d33166ff325b4)
(cherry picked from commit b3f0c01a9d7b31138a08d86a44bc710554a5b785)
2023-04-29 11:36:49 +01:00
Uwe Kleine-König
4af462fcbc 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)
(cherry picked from commit 617914112467ea75c7f33c4415e307d26fc1e242)
(cherry picked from commit 56c756b183d14245fc6f0d17b18b37202a0d8429)
2023-04-29 11:36:49 +01:00
Sorah Fukumori
2866dee297 man: netdev: Clarify wireguard IPv6 endpoint format
(cherry picked from commit 744b04c5571eb1518e686dce505357aa3fb94ce8)
(cherry picked from commit 16dc17d68c9b56e464fdad258623cebe26b3fcd6)
(cherry picked from commit 6e02302292c2382c412ecdcaa20e9083bf0a9079)
2023-04-29 11:36:49 +01:00
Yu Watanabe
2ae7492eac man: mention -o option for systemd-journal-remote
(cherry picked from commit bc729e81f2622961ef8428df46bb000197706f70)
(cherry picked from commit 018461aaf0e93d22d0e171e97452d545c8d1d86c)
(cherry picked from commit 483048e42961bc43b011f1156df61acaf8ca6b7f)
2023-04-29 11:36:49 +01:00
Luca Boccassi
7245c4bdba man: add example for sd_bus_call_method
(cherry picked from commit ce199d12e9a88286271dec6f22cd2c61f1cd7f54)
(cherry picked from commit 8b1cc644c5c80b85d170cbb7c6745cf75915ad2f)
(cherry picked from commit 75ee851a416caae424b3c3c37f399138f8044d20)
2023-04-29 11:36:49 +01:00
Lennart Poettering
7d728849c2 man: link up new online coredump docs from man page
(cherry picked from commit bba6046b241c0e073a6f70ef1f418434c72d3161)
(cherry picked from commit 960f05945c98bf965d8e7642fec2c8c9d8b6d5b7)
(cherry picked from commit 14a5056e5c68a410047cfad443ea223cdea6c82d)
2023-04-29 11:36:49 +01:00
Luca Boccassi
8e18fbb3f8 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)
(cherry picked from commit 18afac6e9086fd92835b0695ac1981149ef6ed32)
(cherry picked from commit cde5615a444bd52e235dfcbfe1e64f7b1ff7a139)
2023-04-29 11:36:49 +01:00
Lennart Poettering
3a4b6c7f87 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)
(cherry picked from commit a2ef3c97bd38d189a4b2cb5c6248f01558c7c9d8)
(cherry picked from commit 34e83c24a7bb3da69676b18dcfe39fb0fbfe6729)
2023-03-31 08:51:57 +02:00
Frantisek Sumsal
7a6108ee82 man: s/io.systemd.Dropin/io.systemd.DropIn/
(cherry picked from commit 8f572d0d82f2f8bb3995faa569da5af1ef7a427d)
(cherry picked from commit 5d2588b5940b03c72371ec2af84dc79ed5703e85)
(cherry picked from commit 50a9e9a5b00198fef046fac4078ebd3b5ab27d18)
2023-03-31 08:51:57 +02:00
Antonio Alvarez Feijoo
8f7f6feaca 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)
(cherry picked from commit 2a8c1168b11f7144d98fa126bc9a06a2bc92383d)
(cherry picked from commit 357a3f1d2b65b5ed9472e33849e644d790ca928a)
2023-03-31 08:51:57 +02:00
Addison Snelling
f9ed8cc70d man: fix misspelled executable name (#26858)
(cherry picked from commit 0c868e3fada33c7139112f0268c29307bdcd6ee7)
(cherry picked from commit 37f65e46d3a4ecb6cc1a48bd5ee72d8342609077)
(cherry picked from commit 8a711f1c26a982d708daadb959589db68993e2c7)
2023-03-31 08:51:56 +02:00
Daan De Meyer
3d3616a46e 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)
(cherry picked from commit 16183e66f63f2023f77a3088c8a8ca7f3de9db59)
(cherry picked from commit 56c4a34fa03a724d2425c55400fe258987ad69b4)
2023-03-31 08:51:56 +02:00
Zbigniew Jędrzejewski-Szmek
a50500c28f 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)
(cherry picked from commit c7afeee1e6b42d2c68074dc0b89ace502a16315b)
(cherry picked from commit 1114a7a52215777e6c87d9e96514846f1b215d47)
2023-03-31 08:51:56 +02:00
Yu Watanabe
459d487f4a man: mention systemd-growfs-root.service
(cherry picked from commit 61ccf030aef82e335941260b82381d0056b475c7)
(cherry picked from commit b8b20dc261751598b8b4ddfcd9c2e3244b938571)
(cherry picked from commit 0e29ec09dd35cfe244af88c778605cd0033a7874)
2023-03-31 08:51:56 +02:00
Yu Watanabe
ce2f4e2c11 man: mention systemd-fsck-usr.service
(cherry picked from commit 5e9750533586efa3d480ac2bc4cf8549993bc3f1)
(cherry picked from commit 20f71ba98f9e55796693cdbd5d0416c372a7056c)
(cherry picked from commit 720cb50229e6c8d5ecdf44a3d4b8c050743d4f49)
2023-03-31 08:51:56 +02:00
Lennart Poettering
09174303d1 man: add two missing commands to synopsys
(cherry picked from commit aff131775b002ddac74b1c65d849dcd52a02c06d)
(cherry picked from commit dc98d58dd8864d537d38cc78617c0a1bf7385ee8)
(cherry picked from commit 7d3af1ff11d17e4cac02668537e6e59e78fe5fc4)
2023-03-03 15:40:05 +01:00
Zbigniew Jędrzejewski-Szmek
88302d7f84 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)
(cherry picked from commit aac692160ef2a88f4a725f7ade900c6bd6b36641)
(cherry picked from commit e72f1676afe4ceae96583e848d023f1b6ec3d6c4)
2023-03-03 15:38:12 +01:00
ml
067b5b7e89 man: fix directory for user home bind mounts
(cherry picked from commit f39d7d00a31c1867d5fa41b3dd4e6d20665a8f3a)
(cherry picked from commit bfaf02348e1086c9ce2e4503ef03dc75ed4f1afb)
2023-02-16 10:46:26 +00:00
Zbigniew Jędrzejewski-Szmek
a05470812a man: fix section number
Fixes #26376.

(cherry picked from commit 359c14368e64ea4714b84d7f5311fd8c3f9c91c1)
(cherry picked from commit ebada36b7bd499355d0f486ce2f5bf39ffd1069c)
2023-02-13 14:50:14 +00:00
Luca Boccassi
158760941f 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 398dc7d39b9a877e71529f0e0b139329e4c6992e)
(cherry picked from commit f0126ad7f90a37c6c81e735726a3bbea1aa6d4d7)
2023-02-13 14:50:14 +00:00
David Tardon
48251e428f 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 218cfe23354397ded28ac898f82b52724f48dae7)
(cherry picked from commit 25e30725d7d31d747a40a5c0ab387dc9f48f09e3)
2023-01-27 09:46:47 +00:00
Zbigniew Jędrzejewski-Szmek
253cc95c64 Revert "cryptsetup: support keyfile-timeout for using a device as the key file"
This reverts commit 64f0e5385139a86f2df7f78fa67ade2075726db5.

On Wed, Dec 21, 2022 at 06:19:08PM +0100, Marius Schwarz wrote:
> That patch made things worse and is disfunctional for both, usb drive and
> password.
>
> No idea if more patches are needed, but this build does not unlock a drive
> at all, if usb is configured.
2022-12-22 17:30:53 +01:00
Chih-Hsuan Yen
64f0e53851 cryptsetup: support keyfile-timeout for using a device as the key file
Closes https://github.com/systemd/systemd/issues/21993

(cherry picked from commit 7aa0b0121e2eef5d4caa676e746faed99d9ab097)
2022-12-21 15:35:48 +01:00
Neil Moore
df977d44e3 virt: Support detection of LMHS SRE guests
(cherry picked from commit d833ed781f61b820e7abb17caa85c3c37c7ea807)
(cherry picked from commit 0ba8e9ecff068bfdeba4f8aa8b0e030f577b0892)
2022-12-14 17:52:33 +01:00
Zbigniew Jędrzejewski-Szmek
03514a9f64 man: add note that network-generator is not a generator
Also fix indentation.

(cherry picked from commit 2fa6574e835566c2aa5cbf4167ecee316f71bf98)
(cherry picked from commit dbed9051f701bfb1f0df1e19f01538348280d498)
2022-11-08 14:00:17 +00:00
Daan De Meyer
8c8a423821 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 300bba79c22e4be1effe2faad0e59ac725d396a1)
(cherry picked from commit 1757446e8bc4dc076badd5c1ad53a0021c42638c)
2022-11-08 11:21:08 +00:00
Frantisek Sumsal
ee42e84968 man: use the correct 'Markers' property name for marking units
Follow-up to c9615f7352 and 70666e28a1.

(cherry picked from commit 1ca1bb03dec9ae3e8d734bd40eeb60210ffd7a0a)
2022-11-03 17:10:52 +01:00
Steve Ramage
6fc2f387af man: Add documentation for AssertCredential= (#25178)
Fixes #25177.

Co-authored-by: Steve Ramage <gitcommits@sjrx.net>
(cherry picked from commit 1d87f03a6e62476b996bccaba62af329aa40ba1c)
2022-11-03 16:49:37 +01:00
Nick Rosbrook
c339e8d71b man: document reboot --poweroff exception
When reboot is invoked, the -p/--poweroff option is intentionally
ignored. Update the man page to reflect this exception.

(cherry picked from commit 6dfaeac3704c68a1e297cef0c08e5b6ee1dbf3b7)
2022-11-03 16:49:16 +01:00
Lennart Poettering
d1066f33b5 man: document restrictions on naming interfaces
Let's document that "." is a bad choice of character when naming
interfaces. Let's also document the hard restrictions we make when
naming interfaces.

Result of the mess that is #25052.

(cherry picked from commit 8f598a463571608cbeb1b562afcadf2db335a530)
2022-10-24 20:48:11 +02:00
anarcat
78a8e938e4 man/shutdown: document how to switch to single-user mode
Before Debian switched to systemd, `shutdown now` would reset the system into
single user mode, doing roughly the equivalent of `telinit 1`.

Now, systemd's `shutdown` command does not behave that way; it defaults to
`poweroff` which might be confusing for users (like me) used to the previous
method.

Because I don't use the command often, I keep being stumped by this behavior,
and every time I look at the `shutdown(1)` manpage, I don't understand why I
can't find what I am looking for. This patch should make sure that people like
me find their way back to some sort of reason.

Maybe the *proper* way to fix this would be to restore the more classic
behavior, but I'm definitely not going to climb that hill. Besides, I clearly
remember the time I found out about the `shutdown` command and was *really*
confused when it brought me back to a command-line prompt. That was really
counter-intuitive and I find that change to actually be a good thing. So I'm
not proposing to change this behavior, merely document it better.

I originally added this to the `-P` option but it was suggested adding a new
`COMPATIBILITY` section instead, where other such issues could be added.

The `COMPATIBILITY` section is not actually officially documented. `man(1)`
talks about a `CONFORMING TO` section, but `shutdown(1)` is not
POSIX (`shutdown(2)` is, of course), so there's no actual standard on how this
should work.

The other option I considered was to add a `BUGS` section, but that seemed to
inflammatory, and definitely counter-productive.

(cherry picked from commit 9aafd310cc42716a923e0d40e56db7952e16a9a3)
2022-10-13 22:53:23 +02:00
Lennart Poettering
c4fd38f7d2 man: document the Dump() calls of the PID 1 D-Bus interface, and what they are
(cherry picked from commit 0df8512124b05ed2d3be1537a4023e89ec33f0f7)
2022-10-01 19:05:54 +02:00
Yu Watanabe
054cad0097 man: explicitly document that "reboot -f" is different from "systemctl reboot -f"
Closes #24696.

(cherry picked from commit cb19517490104553907bb0b118cd2005d6e379cc)
2022-10-01 19:05:54 +02:00
Jade Bilkey
44660d2e12 man: fix static bridge example
A NetDev is needed to create the bridge in order to match the example's description "This creates a bridge..."

(cherry picked from commit bc33789a06e5a727fa4662b0dfcbe02ef7e46687)
2022-10-01 19:05:54 +02:00
Zhaofeng Li
cd2fad2300 virt: Support detection of Apple Virtualization.framework guests
(cherry picked from commit f5558306746c0791dab666e76d51e7ef1ce38362)
2022-10-01 19:05:53 +02:00
David Jaša
951e99231e check-os-release.py compatible with Python < 3.8
The ":=" operator was only added in Python 3.8 so splitting the line with it into two makes check-os-release.py actually fulfill its claim of working with any python version.

(cherry picked from commit ce0a056abc41168e1b45537505ca9f65bf6f5c30)
2022-10-01 19:05:53 +02:00