1
1
mirror of https://github.com/systemd/systemd-stable.git synced 2025-01-22 22:03:43 +03:00

7236 Commits

Author SHA1 Message Date
Michael Vasseur
9f173a4692 pkg.m4 macro needs brackets
See documentation at: https://manpages.debian.org/testing/pkgconf/pkg.m4.7.en.html

Without this the macro was not always correctly resolved so the correct command was not used in the rest of the snippet.

(cherry picked from commit c91d636fadc07169641e8a96a2c60083a15e0f77)
(cherry picked from commit 01841ae82935bdd4f8b01af800f5c53c0fb2adbe)
(cherry picked from commit 1ab8d2198801adc02ec5343254369863134161c5)
2023-09-08 16:35:10 +01:00
Zbigniew Jędrzejewski-Szmek
dd6d4d3530 man/gpt-auto-generator: avoid saying "negative" for boolean
Fixes #28928.

(cherry picked from commit 7abb0eef8fe4510e04c365778489af01ad562587)
(cherry picked from commit 9d43d9e8c54933ffda8b9b31948c597ff8fee9de)
(cherry picked from commit 41a3e30b12f9f165394653908826fb9b51eb2faf)
2023-09-08 16:35:10 +01:00
Lennart Poettering
cdc909df51 man: mention two more things logind does
Prompted by: #28902

(cherry picked from commit 1126841553a28f22eb6bc55eeed8af8d98610f71)
(cherry picked from commit bec4bb92e24fd284974a2d9e4e67563da2732cbb)
(cherry picked from commit 4e51e336c8a60b4245aedb9fa9f401d75f2ee19c)
2023-09-08 16:35:10 +01:00
Lennart Poettering
7cc3d1e341 coredump: explicitly document that in order to process a coredump we have to write it to disk first
Prompted by: #28740

(cherry picked from commit 85ec1b6efadf3466bd1d265950f3d967a43cb1d0)
(cherry picked from commit a5d9940957bf7a3a90a9fc41b6a4d76cfe85aa59)
(cherry picked from commit 495f887e551b0e37d0db58811a75121e699221f1)
2023-09-08 16:35:10 +01:00
mordner
c3ec635648 man: fix typo in journalctl
(cherry picked from commit 653c90ec0e6f4d68b68938a20bd8cff492e7a666)
(cherry picked from commit b4b4caf09f2826266fbe70d0de1c6276f2670bd7)
(cherry picked from commit 6b1a3e05d096baeca20cea32bba4abf98860708a)
2023-08-10 09:43:05 +01:00
Mike Yuan
d6068860d9 man/systemd.unit: DefaultTimeoutStartSec= -> DefaultDeviceTimeoutSec=
for device unit job timeouts

Follow-up for #24044

(cherry picked from commit 83d373d213cad0f67c85055bf342d36cef8ed8e6)
(cherry picked from commit a5e5d6d64e7f9fb1fa245c5cabddd2d1dcccfcaf)
(cherry picked from commit 4d79082c00910a1410872da9bec185f1e6662a96)
2023-08-10 09:43:05 +01:00
Antonio Alvarez Feijoo
1db9a188e9 man/systemd-fsck@.service: clarify passno and noauto combination in /etc/fstab
Fixes #28657

(cherry picked from commit 000680a68dbdb07d77807868df0b4f978180e4cd)
(cherry picked from commit 9c1b5911af27193bf92780dc231fe523cecf4c24)
(cherry picked from commit af6c953148d048a9d2bac2d17c9ad833c3105af7)
2023-08-10 09:43:05 +01:00
Yu Watanabe
6f042e541c man: move <varlistentry> in <variablelist>
(cherry picked from commit 16a07ffc64e6ab855d2d93f14b2aa5f32c6c47ac)
(cherry picked from commit ef5a65a41f8166079568e61aac36bbd5fb1726e1)
2023-07-18 10:11:33 +01:00
Lennart Poettering
75d007b618 man: properly close XML tags
(cherry picked from commit cc8fdd5d307a620700d4729d74143ca434f0707c)
(cherry picked from commit f08c49b33e3ecba9f034dfd3e045b1ef455845a6)
2023-07-08 10:42:52 +01:00
Lennart Poettering
4a54e90a12 man: rebreak lines in file-hierarchy(7) a bit
(Does not change a single word, just rebreaks a bunch of paragraphs
matching our current line breaking rules)

(cherry picked from commit fa1d34825a9b410275e716b9b70f4fca02c71ba9)
(cherry picked from commit ed87814cdf10581728ad56c8012a1141f5fda289)
2023-07-08 10:42:52 +01:00
Antonio Alvarez Feijoo
45a5ca8dc5 man: fix references to gethostname/sethostname
(cherry picked from commit 191b891bf1b01c1041509b951d9d797ceacb181d)
(cherry picked from commit 69298e3b65b142a40800e3073a0dfbb59288eadf)
2023-07-08 10:42:52 +01:00
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