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

7233 Commits

Author SHA1 Message Date
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 85ec1b6efa)
(cherry picked from commit a5d9940957)
(cherry picked from commit 495f887e55)
2023-09-08 16:35:10 +01:00
mordner
c3ec635648 man: fix typo in journalctl
(cherry picked from commit 653c90ec0e)
(cherry picked from commit b4b4caf09f)
(cherry picked from commit 6b1a3e05d0)
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 83d373d213)
(cherry picked from commit a5e5d6d64e)
(cherry picked from commit 4d79082c00)
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 000680a68d)
(cherry picked from commit 9c1b5911af)
(cherry picked from commit af6c953148)
2023-08-10 09:43:05 +01:00
Yu Watanabe
6f042e541c man: move <varlistentry> in <variablelist>
(cherry picked from commit 16a07ffc64)
(cherry picked from commit ef5a65a41f)
2023-07-18 10:11:33 +01:00
Lennart Poettering
75d007b618 man: properly close XML tags
(cherry picked from commit cc8fdd5d30)
(cherry picked from commit f08c49b33e)
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 fa1d34825a)
(cherry picked from commit ed87814cdf)
2023-07-08 10:42:52 +01:00
Antonio Alvarez Feijoo
45a5ca8dc5 man: fix references to gethostname/sethostname
(cherry picked from commit 191b891bf1)
(cherry picked from commit 69298e3b65)
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 dc7e580e64)
(cherry picked from commit b9990ee4a7)
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 173d47f788)
(cherry picked from commit 3c891618b7)
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 730bdfed81)
(cherry picked from commit b16d01b484)
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 cf4dbd84ac)
(cherry picked from commit 20607d7e0c)
2023-07-08 10:42:52 +01:00
Anatoli Babenia
f00dd04930 man: document "s" is default --vacuum-time= suffix
(cherry picked from commit 5c193a7c3c)
(cherry picked from commit 0d82670b1c)
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 768fcd779f)
(cherry picked from commit fec335082f)
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 2efddcb245)
(cherry picked from commit 1c07e6206c)
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 3397a14327)
(cherry picked from commit e413627c91)
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 3122f4d752)
(cherry picked from commit cc13c367f2)
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 dbbf0618d0)
(cherry picked from commit e552fce042)
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 438874cb10)
(cherry picked from commit e056ef5dfb)
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 9e7e9c72c4)
(cherry picked from commit 8be304237a)
2023-07-08 10:42:52 +01:00
Frantisek Sumsal
dc0fa5e67f man: document OnSuccessJobMode=
Introduced in 294446dcb9.

(cherry picked from commit e87abe8206)
(cherry picked from commit b3bdd7efb8)
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 673ed95966)
(cherry picked from commit 121bbb59f3)
2023-07-08 10:42:52 +01:00
David Tardon
ad82535635 man: add trailing =
(cherry picked from commit 30765fcb16)
(cherry picked from commit ed799b98a1)
2023-07-08 10:42:52 +01:00
Zbigniew Jędrzejewski-Szmek
5cfc6e18b7 man: extend description of --boot
(cherry picked from commit a3256ea8f4)
(cherry picked from commit 286ce2be44)
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 d936595672)
(cherry picked from commit 3cf401e3e3)
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 bd2538b50b,
specifically changes to the description of service state between auto-restarts.

Fixes #27594

(cherry picked from commit 2200cf47ce)
(cherry picked from commit e85daabd3e)
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 f90360eb74)
(cherry picked from commit 3e286a7b2e)
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 2f76f1cfae)
(cherry picked from commit cb6641bde3)
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 42eccfec6e)
(cherry picked from commit 65bf6c5a8f)
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 7e0aaeb244)
(cherry picked from commit 29115ef32e)
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 4fad639a13)
(cherry picked from commit 32831842ba)
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 2b43ab00b0)
(cherry picked from commit cd795f9abc)
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 b4e5c103be)
(cherry picked from commit b1ecfe3fe7)
2023-04-28 16:29:56 +01:00
Luca Boccassi
7bcdbf4301 man: fix LogControl1 manpage example
Follow-up for c6b8fffdfa

(cherry picked from commit 33054db730)
(cherry picked from commit 59243061f6)
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 f0f7cbd488)
(cherry picked from commit 5a8987794e)
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 c6b8fffdfa)
(cherry picked from commit b9af9a320e)
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 a108fcbace)
(cherry picked from commit 3ee1839c19)
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 dd9f909ea8)
(cherry picked from commit f86ec34958)
2023-04-28 16:29:56 +01:00
Franklin Yu
696c0ed616 Fix cross-reference of manual for LogsDirectory
(cherry picked from commit 8dacdd28f4)
(cherry picked from commit 430861fc96)
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 5015b5014b)
(cherry picked from commit 1fb4ae32b0)
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 5a9e2dff47)
(cherry picked from commit 841146f243)
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 381ccb4246)
(cherry picked from commit 6179141124)
2023-04-28 16:29:56 +01:00
Sorah Fukumori
6e02302292 man: netdev: Clarify wireguard IPv6 endpoint format
(cherry picked from commit 744b04c557)
(cherry picked from commit 16dc17d68c)
2023-04-28 16:29:56 +01:00
Yu Watanabe
483048e429 man: mention -o option for systemd-journal-remote
(cherry picked from commit bc729e81f2)
(cherry picked from commit 018461aaf0)
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 6d48c7cf73.

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

(cherry picked from commit c32f496b9e)
(cherry picked from commit 0430078cfb)
2023-04-28 16:29:56 +01:00
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