1
1
mirror of https://github.com/systemd/systemd-stable.git synced 2025-03-13 12:58:20 +03:00

7406 Commits

Author SHA1 Message Date
Yu Watanabe
ef5a65a41f man: move <varlistentry> in <variablelist>
(cherry picked from commit 16a07ffc64e6ab855d2d93f14b2aa5f32c6c47ac)
2023-07-17 16:49:41 +02:00
Lennart Poettering
f08c49b33e man: properly close XML tags
(cherry picked from commit cc8fdd5d307a620700d4729d74143ca434f0707c)
2023-07-07 19:30:52 +01:00
Lennart Poettering
ed87814cdf 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)
2023-07-07 19:30:52 +01:00
Lennart Poettering
a90ec12d82 man: rework BPFForeign= documentation a bit
Various assorted changes, among them make clear that a missing BPF
program is not reason to abort unit activation.

(cherry picked from commit a27e6fb71bf70f27347b0e1167b2de32c4dc6637)
2023-07-07 19:30:52 +01:00
Antonio Alvarez Feijoo
69298e3b65 man: fix references to gethostname/sethostname
(cherry picked from commit 191b891bf1b01c1041509b951d9d797ceacb181d)
2023-07-07 19:30:52 +01:00
Frantisek Sumsal
b9990ee4a7 tree-wide: use https for the 0pointer.de doc links
(cherry picked from commit dc7e580e64a80e982619fb099ef736cd2379f92a)
2023-07-07 19:30:52 +01:00
Jan Luebbe
3c891618b7 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)
2023-07-07 19:30:52 +01:00
Lennart Poettering
0625ef75b6 man: place options in a some limited form of subsections
Let's visually separate the options associated with cpu, io, memory, …
in subsections

This patch tries to be minimal. It just adds the section titles, and
does minimal reordering to make sure the options on the same kind of
resource are placed close to each other.

(cherry picked from commit 5cbfbf2aaac66111584798fdb38f243f8593444e)
2023-07-07 19:30:52 +01:00
Zbigniew Jędrzejewski-Szmek
b16d01b484 man/systemd-nspawn: fix indentation and parenthesis location
(cherry picked from commit 730bdfed8173d508d4202b0bee957ab70b1e16a1)
2023-07-07 19:30:52 +01:00
Henrik Holst
20607d7e0c 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)
2023-07-07 19:30:52 +01:00
Anatoli Babenia
0d82670b1c man: document "s" is default --vacuum-time= suffix
(cherry picked from commit 5c193a7c3cba491a530556b7143e3a49ef704847)
2023-07-07 19:30:52 +01:00
Lennart Poettering
fec335082f 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)
2023-07-07 19:30:52 +01:00
Lennart Poettering
1c07e6206c 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)
2023-07-07 19:30:52 +01:00
Luca Boccassi
e413627c91 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)
2023-07-07 19:30:52 +01:00
Lennart Poettering
cc13c367f2 man: document that "systemctl mask" doesn't work for units whose file is in /etc
Fixes: #27965
(cherry picked from commit 3122f4d752d849f5d573f24f90a3a56020da59ba)
2023-07-07 19:30:52 +01:00
Lennart Poettering
e552fce042 man: reference naming of triggered services of timer unit
Fixes: #27116
(cherry picked from commit dbbf0618d073690705aaf305b94b269b5c2e641a)
2023-07-07 19:30:52 +01:00
Lennart Poettering
e056ef5dfb man: document how calendar times catch up after system suspend/hibernation
Fixes: #26166
(cherry picked from commit 438874cb105736e1fb59d67127c42a68f30bdf20)
2023-07-07 19:30:52 +01:00
Lennart Poettering
8be304237a man: mention that OnCalendar= combines well with systemd-time-wait-sync.service
Fixes: #23440
(cherry picked from commit 9e7e9c72c4664ce88d526a6977615c063120f6c1)
2023-07-07 19:30:52 +01:00
Lennart Poettering
b1c24b6f6f man: document which IP ports resolved listens on, and what for
Fixes: #23045
(cherry picked from commit bef84b81a4ac2dbb3069c8a705a0368516bb21c6)
2023-07-07 19:30:52 +01:00
Frantisek Sumsal
b3bdd7efb8 man: document OnSuccessJobMode=
Introduced in 294446dcb9.

(cherry picked from commit e87abe82069bb4f473e853a8a15e1cf18365c04a)
2023-07-07 19:30:52 +01:00
Hannu Lounento
121bbb59f3 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)
2023-07-07 19:30:52 +01:00
David Tardon
ed799b98a1 man: add trailing =
(cherry picked from commit 30765fcb16cdc78c0f27a007bb8cfc3237246d47)
2023-07-07 19:30:52 +01:00
Vitaly Kuznetsov
4810e789ad man: fix UKI filename suffix in 'tries' description
Boot Loader Type #2 entries (UKIs in $BOOT/EFI/Linux/) have '.efi' suffix,
not '.conf'.

(cherry picked from commit ce8dc0bd6b365c991d1d4409ab99141c4b731426)
2023-06-01 16:37:09 +02:00
Zbigniew Jędrzejewski-Szmek
286ce2be44 man: extend description of --boot
(cherry picked from commit a3256ea8f4684ff92622ca9df1dc18dc517a4c6e)
2023-06-01 16:37:09 +02:00
Luca Boccassi
3cf401e3e3 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)
2023-06-01 16:37:09 +02:00
Mike Yuan
e85daabd3e 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)
2023-06-01 16:37:09 +02:00
Zbigniew Jędrzejewski-Szmek
3e286a7b2e man/tmpfiles: fix off-by-one in example
Reported and diagnosed by gitterman. Fixes #26617.

(cherry picked from commit f90360eb7417e083650034ad819790df0c389bd1)
2023-06-01 16:37:09 +02:00
Zbigniew Jędrzejewski-Szmek
cb6641bde3 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)
2023-06-01 16:37:09 +02:00
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