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

7225 Commits

Author SHA1 Message Date
Frantisek Sumsal
140cb87e06 tree-wide: use https for the 0pointer.de doc links
(cherry picked from commit dc7e580e64a80e982619fb099ef736cd2379f92a)
(cherry picked from commit b9990ee4a73332b4254c0b24e2807919be0d7ea3)
2023-07-08 10:42:52 +01:00
Jan Luebbe
08c8bb3acf man: correct reference to sd_id128_get_boot_app_specific
The function sd_id128_get_boot_app_specific is the app specific variant of
sd_id128_get_boot.

Signed-off-by: Jan Luebbe <jlu@pengutronix.de>
(cherry picked from commit 173d47f7881137a5994a3e3b918169b6c759deaf)
(cherry picked from commit 3c891618b781d23a4aeb9ccee9590df2bb2da3cf)
2023-07-08 10:42:52 +01:00
Zbigniew Jędrzejewski-Szmek
36ce0edc50 man/systemd-nspawn: fix indentation and parenthesis location
(cherry picked from commit 730bdfed8173d508d4202b0bee957ab70b1e16a1)
(cherry picked from commit b16d01b484a418ec037ac15195cc502d7dadb084)
2023-07-08 10:42:52 +01:00
Henrik Holst
84887588c3 network: make degraded-carrier bond/bridge as routable (#27776)
This makes a bond or bridge interface in the degraded-carrier state but has a routable address
handled as routable operational state.

If the carrier is degraded but the address state is routable then the operational state should be
seen as routable and not degraded because that may be the case for bonds if some of the links are down,
but when that happens the bond as whole is still routable.

This also makes operational state to degraded if address state is degraded even if the link state is
degraded-carrier.

Fixes #22713.

(cherry picked from commit cf4dbd84ac31bbfcab905bc02bf03f67acca7413)
(cherry picked from commit 20607d7e0c7ff730bcd461344f3a861f660039ca)
2023-07-08 10:42:52 +01:00
Anatoli Babenia
f00dd04930 man: document "s" is default --vacuum-time= suffix
(cherry picked from commit 5c193a7c3cba491a530556b7143e3a49ef704847)
(cherry picked from commit 0d82670b1c26e3ad3b30f37a17389179d3b7b454)
2023-07-08 10:42:52 +01:00
Lennart Poettering
f8e8ff5126 socket: bump listen() backlog to INT_MAX everywhere
This is a rework of #24764 by Cristian Rodríguez
<crodriguez@owncloud.com>, which stalled.

Instead of assigning -1 we'll use a macro defined to INT_MAX however.

(cherry picked from commit 768fcd779fbb9fd86932da4bef031260b88da210)
(cherry picked from commit fec335082f59ec9e86cc2dd20a5e4001e6a71d9b)
2023-07-08 10:42:52 +01:00
Lennart Poettering
38011797cf man: explain timesyncd epoch mtime touch files in a bit more detail
Let's mention what /usr/lib/clock-epoch precisely does, and underline we
only *advance* the time based on it.

Inspired by Darkdragon-001's #23214.

Replaces #23214

(cherry picked from commit 2efddcb24551521b75542043d033e39338207de8)
(cherry picked from commit 1c07e6206cbe15ec2f963a65711c06933b2cb5a1)
2023-07-08 10:42:52 +01:00
Luca Boccassi
40fde75009 man: 'flag' parameter in portable1 spec is now used
It has been used for a while, and it is described fully a couple of
paragraphs below, but this snippet was not deleted.

(cherry picked from commit 3397a14327679f15637cc530c411324a15be3d9f)
(cherry picked from commit e413627c91a5bf1b6c966d7d9c07cf1de0c9687a)
2023-07-08 10:42:52 +01:00
Lennart Poettering
1ca95101f9 man: document that "systemctl mask" doesn't work for units whose file is in /etc
Fixes: #27965
(cherry picked from commit 3122f4d752d849f5d573f24f90a3a56020da59ba)
(cherry picked from commit cc13c367f29e0ad05f376cecc99290cd19cf1fa1)
2023-07-08 10:42:52 +01:00
Lennart Poettering
f57c1692c5 man: reference naming of triggered services of timer unit
Fixes: #27116
(cherry picked from commit dbbf0618d073690705aaf305b94b269b5c2e641a)
(cherry picked from commit e552fce0423ed9701cf532af34509e644a49232e)
2023-07-08 10:42:52 +01:00
Lennart Poettering
c9bbaba834 man: document how calendar times catch up after system suspend/hibernation
Fixes: #26166
(cherry picked from commit 438874cb105736e1fb59d67127c42a68f30bdf20)
(cherry picked from commit e056ef5dfb634947b5d0ec6d7fa9ef5dc127f793)
2023-07-08 10:42:52 +01:00
Lennart Poettering
6979d8870d man: mention that OnCalendar= combines well with systemd-time-wait-sync.service
Fixes: #23440
(cherry picked from commit 9e7e9c72c4664ce88d526a6977615c063120f6c1)
(cherry picked from commit 8be304237a135d9dd4522a9d7f4a399311a0b028)
2023-07-08 10:42:52 +01:00
Frantisek Sumsal
dc0fa5e67f man: document OnSuccessJobMode=
Introduced in 294446dcb9.

(cherry picked from commit e87abe82069bb4f473e853a8a15e1cf18365c04a)
(cherry picked from commit b3bdd7efb8498e1b60148b9b3fe89211accdfb49)
2023-07-08 10:42:52 +01:00
Hannu Lounento
2d2ec1eea4 man: fix sd_journal_*_with_location's func argument
`sd_journal_print_with_location` and similar functions behave
inconsistently compared to their documentation, which says:

    sd_journal_print_with_location(), sd_journal_printv_with_location(),
    sd_journal_send_with_location(), sd_journal_sendv_with_location(),
    and sd_journal_perror_with_location() [...] accept additional
    parameters to explicitly set the source file name, function, and
    line. Those arguments must contain valid journal entries including
    the variable name, e.g. "CODE_FILE=src/foo.c", "CODE_LINE=666",
    "CODE_FUNC=myfunc".

Calling e.g. `sd_journal_sendv_with_location` with
`CODE_FUNC=myfunction` as the value of the argument `func` results in

    "CODE_FUNC" : "CODE_FUNC=myfunction"

because `sd_journal_*_with_location` implicitly prefix the argument
`func` with `CODE_FUNC=`. For example:

    _public_ int sd_journal_sendv_with_location(
                    const char *file, const char *line,
                    const char *func,
                    const struct iovec *iov, int n) {
            [...]
            char *f;
            [...]
            niov = newa(struct iovec, n + 3);
            [...]
            ALLOCA_CODE_FUNC(f, func);
            [...]
            niov[n++] = IOVEC_MAKE_STRING(f);

            return sd_journal_sendv(niov, n);
    }

where `ALLOCA_CODE_FUNC` is:

    #define ALLOCA_CODE_FUNC(f, func)                 \
            do {                                      \
                    size_t _fl;                       \
                    const char *_func = (func);       \
                    char **_f = &(f);                 \
                    _fl = strlen(_func) + 1;          \
                    *_f = newa(char, _fl + 10);       \
                    memcpy(*_f, "CODE_FUNC=", 10);    \
                    memcpy(*_f + 10, _func, _fl);     \
            } while (false)

The arguments `file` and `line` are _not_ prefixed similarly but
expected to be prefixed already with `CODE_FILE=` and `CODE_LINE=`
respectively and sent as is like the documentation describes.

That is, the argument `func` is treated differently and behaves
inconsistently compared to the arguments `file` and `line`. The behavior
seems still intentional:

    _public_ int sd_journal_printv_with_location(int priority, const char *file, const char *line, const char *func, const char *format, va_list ap) {
            [...]
            /* func is initialized from __func__ which is not a macro, but
            * a static const char[], hence cannot easily be prefixed with
            * CODE_FUNC=, hence let's do it manually here. */
            ALLOCA_CODE_FUNC(f, func);
            [...]
    }

Thus, change the documentation to match the actual behavior.

Note: `sd_journal_{print,send}` and `sd_journal_{print,send}v` work as
expected as they only pass the function name (i.e. without `CODE_FUNC=`)
to the `func` argument of the `sd_journal_*_with_location` functions
they call. For example:

    #define sd_journal_print(priority, ...) sd_journal_print_with_location(priority, "CODE_FILE=" __FILE__, "CODE_LINE=" _SD_STRINGIFY(__LINE__), __func__, __VA_ARGS__)

(cherry picked from commit 673ed95966c741807f993f7fd6b5d93bbc504458)
(cherry picked from commit 121bbb59f3075a07c571dca9f7c628eb7433a99b)
2023-07-08 10:42:52 +01:00
David Tardon
ad82535635 man: add trailing =
(cherry picked from commit 30765fcb16cdc78c0f27a007bb8cfc3237246d47)
(cherry picked from commit ed799b98a17a5c64752760ade87a729d2afcf408)
2023-07-08 10:42:52 +01:00
Zbigniew Jędrzejewski-Szmek
5cfc6e18b7 man: extend description of --boot
(cherry picked from commit a3256ea8f4684ff92622ca9df1dc18dc517a4c6e)
(cherry picked from commit 286ce2be44422e53347edd8f79acd5532b96780c)
2023-06-02 13:42:21 +01:00
Luca Boccassi
95193c9853 manager: restrict Dump*() to privileged callers or ratelimit
Dump*() methods can take quite some time due to the amount of data to
serialize, so they can potentially stall the manager. Make them
privileged, as they are debugging tools anyway. Use a new 'dump'
capability for polkit, and the 'reload' capability for SELinux, as
that's also non-destructive but slow.

If the caller is not privileged, allow it but rate limited to 10 calls
every 10 minutes.

(cherry picked from commit d936595672cf3ee7c1c547f8fd30512f82be8784)
(cherry picked from commit 3cf401e3e3713e2952c222cd9e75497016440e73)
2023-06-02 13:42:21 +01:00
Mike Yuan
3d00dba68e 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)
2023-06-02 13:42:21 +01:00
Zbigniew Jędrzejewski-Szmek
cb511894bd 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)
2023-06-02 13:42:21 +01:00
Zbigniew Jędrzejewski-Szmek
fdac06ec81 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)
2023-06-02 13:42:21 +01:00
Zbigniew Jędrzejewski-Szmek
54652191b4 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)
2023-06-02 13:42:21 +01:00
Lennart Poettering
0086c49546 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)
2023-06-02 13:42:21 +01:00
Miao Wang
e63041299b doc: remove legacy DefaultControlGroup from dbus properties
DefaultControlGroup does not exist any more.

(cherry picked from commit 4fad639a1350b1ce2fa77249f8e81dcc4229ee57)
(cherry picked from commit 32831842bade4d91ff00cf2bbbb12008dd55f835)
2023-06-02 13:42:21 +01:00
Yu Watanabe
c8bb1f1403 udev-rules: fix negative match rule for SYMLINK and TAG
Fixes #27396.

(cherry picked from commit 2b43ab00b08a052fc0077dd20f111c474730ad52)
(cherry picked from commit cd795f9abc5407db7b6c1d016e3d3d7d3d6c13db)
2023-05-01 00:39:21 +01:00
Vitaly Kuznetsov
1e8057fce7 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)
2023-04-28 16:29:56 +01:00
Luca Boccassi
7bcdbf4301 man: fix LogControl1 manpage example
Follow-up for c6b8fffdfaf1f7c9a1dac73e1e54993a06c766c0

(cherry picked from commit 33054db730fb6f2fd6221d38a788e30b95525463)
(cherry picked from commit 59243061f62142ee0f74d25e352a55f174f1bb97)
2023-04-28 16:29:56 +01:00
Luca Boccassi
a9e44da6b1 man: clarify sd_bus_default
It picks the bus based on the cgroup slice.

(cherry picked from commit f0f7cbd488fd0e00c5b77baf3b1324240fd7d72d)
(cherry picked from commit 5a8987794eb1cddf43bfe240d241d3a5462c1e5a)
2023-04-28 16:29:56 +01:00
Luca Boccassi
3c9b9aabc5 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)
2023-04-28 16:29:56 +01:00
Florian Klink
23a3efd4e7 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)
(cherry picked from commit 3ee1839c19f1187d04b81a823b62ce26e8f6e595)
2023-04-28 16:29:56 +01:00
ZjYwMj
ef395963a4 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)
2023-04-28 16:29:56 +01:00
Franklin Yu
696c0ed616 Fix cross-reference of manual for LogsDirectory
(cherry picked from commit 8dacdd28f49e0b985d651e7c9f946aa666454063)
(cherry picked from commit 430861fc96585c6a5913b2a84456916e516a1a44)
2023-04-28 16:29:56 +01:00
Michal Sekletar
7c353ca5d6 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)
2023-04-28 16:29:56 +01:00
Zbigniew Jędrzejewski-Szmek
b3f0c01a9d 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)
2023-04-28 16:29:56 +01:00
Uwe Kleine-König
56c756b183 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)
2023-04-28 16:29:56 +01:00
Sorah Fukumori
6e02302292 man: netdev: Clarify wireguard IPv6 endpoint format
(cherry picked from commit 744b04c5571eb1518e686dce505357aa3fb94ce8)
(cherry picked from commit 16dc17d68c9b56e464fdad258623cebe26b3fcd6)
2023-04-28 16:29:56 +01:00
Yu Watanabe
483048e429 man: mention -o option for systemd-journal-remote
(cherry picked from commit bc729e81f2622961ef8428df46bb000197706f70)
(cherry picked from commit 018461aaf0e93d22d0e171e97452d545c8d1d86c)
2023-04-28 16:29:56 +01:00
Zbigniew Jędrzejewski-Szmek
c83236a863 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)
(cherry picked from commit 0430078cfb6e0d7093b1e61c782c6f8a8cd883da)
2023-04-28 16:29:56 +01:00
Luca Boccassi
75ee851a41 man: add example for sd_bus_call_method
(cherry picked from commit ce199d12e9a88286271dec6f22cd2c61f1cd7f54)
(cherry picked from commit 8b1cc644c5c80b85d170cbb7c6745cf75915ad2f)
2023-04-28 16:29:56 +01:00
Luca Boccassi
16aee50c2b man: further shorten print-unit-path example
(cherry picked from commit d10a5f6c3de64fcaa71855d9a94394ea8317038a)
(cherry picked from commit 382e53977c7b156a979004dad85019c72c012375)
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 bba6046b241c0e073a6f70ef1f418434c72d3161)
(cherry picked from commit 960f05945c98bf965d8e7642fec2c8c9d8b6d5b7)
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 a5979f0bd50234ff9cad47f160d121628e0e3bbe)
(cherry picked from commit 18afac6e9086fd92835b0695ac1981149ef6ed32)
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 75f7e5e54704e643aa9b50ce03ed02a49e75333f)
(cherry picked from commit a2ef3c97bd38d189a4b2cb5c6248f01558c7c9d8)
2023-03-30 19:21:34 +02:00
Frantisek Sumsal
50a9e9a5b0 man: s/io.systemd.Dropin/io.systemd.DropIn/
(cherry picked from commit 8f572d0d82f2f8bb3995faa569da5af1ef7a427d)
(cherry picked from commit 5d2588b5940b03c72371ec2af84dc79ed5703e85)
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 9baeb58fcdcd3b8893fc485bb33726820ce46e94)
(cherry picked from commit 2a8c1168b11f7144d98fa126bc9a06a2bc92383d)
2023-03-30 19:08:14 +02:00
Mike Yuan
9ced8895e1 sleep: fix default values unmatched with manual
(cherry picked from commit f05b4bb9a7a70092641f43486fc7a45c85fc9c63)
(cherry picked from commit fd963d1bc806f900fc8a3310f7110fdedac3958d)
2023-03-30 19:06:09 +02:00
Addison Snelling
8a711f1c26 man: fix misspelled executable name (#26858)
(cherry picked from commit 0c868e3fada33c7139112f0268c29307bdcd6ee7)
(cherry picked from commit 37f65e46d3a4ecb6cc1a48bd5ee72d8342609077)
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 7b3693e4e4c9cae50fca65136278a62fae11327e.

(cherry picked from commit 449172f943acadc7fd1e2293a615c7cb0d87fcd6)
(cherry picked from commit 2ead535f0d0ceec9b3b9565ed056c3ccef0779af)
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 80c7d4b8fa9f8283af7f0213739e3463c68a30f6)
(cherry picked from commit 16183e66f63f2023f77a3088c8a8ca7f3de9db59)
2023-03-30 19:02:40 +02:00
Morten Linderud
b1b266b79f man: Fix pcrphase.service manvolnum from 1 to 8
(cherry picked from commit 9e60dc0daffdb3c8b137c9ec529d7942e1c52124)
(cherry picked from commit 67ba5637c0ae6f1c5be218b94f66f8b16b5ef632)
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 695e39dd632801871b4e96b39bc8e7511083a34e)
(cherry picked from commit 4b12a1cf9249a2e59c2824958dfa6d56222c5d68)
2023-03-30 19:01:08 +02:00