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

7448 Commits

Author SHA1 Message Date
Дамјан Георгиевски
de0f0b514a man: typo, it's DHCP not DCHP in DHCPPrefixDelegation=
(cherry picked from commit 51219be99295eee3dbfc3d546fdb75cd29ce5f29)
(cherry picked from commit db14abb864d31e51df996d5c225a88dd99483436)
2023-12-06 11:15:01 +01:00
Vito Caputo
24a9bc76aa man: add note about journald forwarding being sync
This footgun should at least be documented, if there's not going
to be a shortcut setting to establish the async `journalctl
--follow` equivalent.

Fixes: https://github.com/systemd/systemd/issues/2815
(cherry picked from commit 165fb931ea1e70460d5ebd30fa22e3aa6ba8861d)
(cherry picked from commit 97237a52c3a0bf541e29d899886bece507972e93)
2023-12-06 11:15:01 +01:00
Frantisek Sumsal
9a2e80eb15 login: mark the TTY property as "emits change"
Triggered by the SetTTY() method.

Follow-up to 092e6cd19ad.
Addresses: https://github.com/systemd/systemd/pull/30043#pullrequestreview-1733628935

(cherry picked from commit f1e02423a917fa957de6800f391bd814e88dbcbe)
(cherry picked from commit 9fba69e3026b4ccdcdc75d612fbf93045d19864a)
2023-12-06 11:15:01 +01:00
Frantisek Sumsal
7d76b4e96b login: mark the Display property as "emits change"
With the introduction of SetDisplay() method in 4885d7490b2 the Display
property emits a "properties changed" message every time the display is
changed using this method, so mark it appropriately.

Caught by systemd/systemd#30029:

systemd-logind[1366]: Got message type=method_call sender=:1.165 destination=org.freedesktop.login1 path=/org/freedesktop/login1/session/_310 interface=org.freedesktop.login1.Session member=SetDisplay  cookie=8 reply_cookie=0 signature=s error-name=n/a error-message=n/a
systemd-logind[1366]: Assertion 'v->vtable->flags & SD_BUS_VTABLE_PROPERTY_EMITS_CHANGE || v->vtable->flags & SD_BUS_VTABLE_PROPERTY_EMITS_INVALIDATION' failed at src/libsystemd/sd-bus/bus-objects.c:2141, function emit_properties_changed_on_interface(). Ignoring.

Follow-up to 4885d7490b2.

(cherry picked from commit 236cb016222288bdf5be5f2d8f9e81d6e4a6adab)
(cherry picked from commit 89a03cfbfce744c6893089bb9cbe1be77534ca9a)
2023-12-06 11:15:01 +01:00
Lennart Poettering
4a75edd61e man: document explicitly tha ReadWritePaths= cannot undo superblock read-only settings
Fixes: #29266
(cherry picked from commit b6be6a6721e3d7ba0f01cfba135d2d6cf526087b)
(cherry picked from commit 0a358507b596af8b6bd9640693473f45047eecde)
2023-11-09 21:05:51 +00:00
Lennart Poettering
c09313447e man: document that changing --uid= doesn't work
Fixes: #28982
(cherry picked from commit d33121d27d284ae558b576cc07fb8f9bb44b35cd)
(cherry picked from commit 63c7f5833ef265b2238977c715ad69fd11cbea4e)
2023-11-09 21:05:51 +00:00
Lennart Poettering
2dbf94edf6 service: say explicitly that people should not use different NonBlocking= settings if they share socket units between multiple service units
Fixes: #29600
(cherry picked from commit 28562194c49003b8f6af0df24c33b4f6d8a8df1e)
(cherry picked from commit 009e7801843707cf2419ca3582015dc76d733054)
2023-11-09 21:05:51 +00:00
Lennart Poettering
c4958af5db man: explicitly document compat guarantees of cryptenroll vs. cryptsetup
Fixes: #29743
(cherry picked from commit 244101876ccd8dc28e8527d02e3a8ac822dc19ac)
(cherry picked from commit 62d51eb879fa36bf45e522944e07bd5bec44cf48)
2023-11-09 21:05:51 +00:00
Lennart Poettering
318c3afcba man,doc: document some aspects of user record management/homed a bit better
Fixes: #29759
(cherry picked from commit 7480859a11718093db573c41c5ce5f0fc9f816e6)
(cherry picked from commit 912fb76f3abba7e6dbeba0f6134aff99fa8211f8)
2023-11-09 21:05:51 +00:00
Lennart Poettering
a40a4393d6 man: be even clearer that tmpfiles user/group/mode are applied on existing inodes
I think it was clear already, but let's be even clearer.

Fixes: #29774
(cherry picked from commit 3cb938bd12b3603984b982e9b73e4cabd4a608e3)
(cherry picked from commit 9ed9bfe6b1e62f3f44bd6968b406bc87051f8539)
2023-11-09 21:05:51 +00:00
Lennart Poettering
1c09ddd65d man: update COREDUMP_xyz journal fields docs
This completes/corrects the documentation for the following fields:

    COREDUMP_CGROUP= - doc where wrong, actually covered COREDUMP_PROC_CGROUP=
    COREDUMP_CMDLINE= → undocumented so far
    COREDUMP_PROC_CGROUP= → docs where there but incorrectly assigned to COREDUMP_CGROUP=
    COREDUMP_PROC_AUXV= → undocumented so far
    COREDUMP_SESSION= → undocumented so far

Fixes: #29832
(cherry picked from commit a9d54de66d62b1180aef845fae2eabde4968dda5)
(cherry picked from commit be694c89f7c2a8415711971f50bef762ae27c5e8)
2023-11-09 21:05:51 +00:00
Lennart Poettering
7b5fffede1 man: add missing unit file section name to example
Fixes: #29917
(cherry picked from commit 2e290d55fd1ff9483315dcbe86cae091f333d68f)
(cherry picked from commit e57d278da35d2591ca451af57f3d0193a76bb502)
2023-11-09 21:05:51 +00:00
André Paiusco
d387e5df1f man: Improve text for SystemMaxFileSize when not set
If one sets the SystemMaxUse=64G by the current documentation would expect that each files size would be around 1/8 of this value (8G), althought if the SystemMaxFileSize is not explicit set, it has a max of 128M per file.

(cherry picked from commit d397191b6d3001c2920e15e3ce3c9e7a31c66436)
(cherry picked from commit 83bc13e77ae5e27e420ca3e1e3b4da7c1c2e17cc)
2023-11-09 21:05:51 +00:00
Peter Hutterer
cc09085ac3 analyze: handle CAP_BPF support
(cherry picked from commit 4f7a629e6c11fb2f060f18a62d073410ffa5a0ca)
(cherry picked from commit f58b5ce7dc8232f2305b9c8ce2e73b626a9d0dd8)
2023-11-09 21:05:51 +00:00
Lennart Poettering
1d6c94b72b man: explicitly mention that environment.d/ cannot be used to set the service manager's own env block
Fixes: #29414
(cherry picked from commit bebf6fcf223c46f238184389befb2b05f4d2ff10)
(cherry picked from commit bb0a377c52cf23417c7af4601b7bef74beb7e990)
2023-11-09 21:05:51 +00:00
Michal Sekletar
4b4ef92bad man: change title of the section to better reflect actual content
(cherry picked from commit 448a21abbd23d18c0ed50c894b9f73118112dc55)
(cherry picked from commit 29e61fbea5b90a61b20027407840ff2c40412c69)
2023-11-09 21:05:51 +00:00
Michal Koutný
147ad7d0a3 man: Add remarks about StandardInput=socket and sd_listen_fds()
It confuses users when they cannot find respective environment variables
with config that is supposes for (x)inetd activated service only.

Fix: #29670
(cherry picked from commit 788b7e7630669a47c54c6f3299af14db26ca7fe0)
(cherry picked from commit 136dc1c818aab93301032664931765f6285d0ba8)
2023-11-09 21:05:51 +00:00
Alex Hudspith
271026144d man: revise wording of cgtop -k and -P
Resolves: #29753
(cherry picked from commit ade790006b20e0788e8fa7cef2ae92cfd666d068)
(cherry picked from commit 8649d06cfe8882ea5129677aa5134feff2212b63)
2023-11-09 21:05:51 +00:00
Mike Yuan
de771adb6b man/systemd.unit: add PropagatesStopTo= to reverse property table
(cherry picked from commit 8c29f6a572318fc4de63b084e2ee94021d52459a)
(cherry picked from commit 0c2e0082e23977da1112ce7d22024808d3795f5a)
2023-11-09 21:05:51 +00:00
Joerg Behrmann
e31805d26a credentials: document that their path is stable for system services
(cherry picked from commit cf37171890bdaec1dc0cd56828047f4eb899fc3a)
(cherry picked from commit 823216d61f6291d7fc13c271bfda368513440a4c)
2023-11-09 21:05:51 +00:00
Lennart Poettering
b5e10fd566 man: document the order in which we talk to DNS servers
(cherry picked from commit 612a91c11ae2c3183cb27fa0841a997eefb71fbb)
(cherry picked from commit 259a6a3f51f425c08688c56c2cf23d37bb0aa2df)
2023-11-09 21:05:51 +00:00
Roland Hieber
5cacdfdb20 sd-gpt: add defines for big-endian MIPS/MIPS64
According to the respective change in the DPS:
<https://github.com/uapi-group/specifications/pull/86>

Signed-off-by: Roland Hieber <rhi@pengutronix.de>
(cherry picked from commit 7c6dd200468f88c189d042c7ee25547032e296cd)
(cherry picked from commit 9f415a6347f6dbe725da5ef632b33e422a2845e8)
2023-11-09 21:05:51 +00:00
Daan De Meyer
61c5e3715d repart: Mention that xattrs are not copied when populating XFS with protofile
(cherry picked from commit 0e70150be31dbd748c7d2c66b2098998cea66c53)
(cherry picked from commit 8998892badd1d96cba2d52d8b5f87564b2d37ce0)
2023-11-09 21:05:51 +00:00
Mike Yuan
a8b7bf4e3d man/systemd.exec: document that API fs are required to setup namespacing
Closes #27997

(cherry picked from commit 723c3cd03ce38235df948147150054ce95cb41df)
(cherry picked from commit c371368887611016f9171148f1b0c0b4fc582122)
2023-11-09 21:05:51 +00:00
Mike Yuan
e378c3360a man/systemd.exec: suffix one more directory with /
(cherry picked from commit 6460a89a1be7c11bc7b66a134701a07773869849)
(cherry picked from commit 188f7c043a077a7a01a7bc7bcb0bc34ffe89bfc8)
2023-11-09 21:05:51 +00:00
Yu Watanabe
ee58332333 man: update the list of ignored options by Anonymize=yes
Closes #29362.

(cherry picked from commit fcf17d693c063733addad26115271baf4b433857)
(cherry picked from commit 065725aba3d7931c7c262716ee716b7631c2dabd)
2023-11-09 21:05:51 +00:00
Zbigniew Jędrzejewski-Szmek
522ebdcfd4 man/crypttab: fix indentation
(cherry picked from commit 5f5f1ba169b12cb342fb939a02bd8336eb9be69e)
(cherry picked from commit e78fdc8ae99a4e2e0f0ee040c4ae7969d46671ec)
2023-11-09 21:05:51 +00:00
Zbigniew Jędrzejewski-Szmek
bf19ea3fb9 man/cryptenroll: link to crypttab(5) for examples
I was missing an example of how to use cryptenroll. We have that, but in
another page. Instead of repeating, let's just direct the user to the right
place.

Also, reformat synopsis to the "official" non-nested syntax.

(cherry picked from commit 38e3c61dbb1ad69e7df910d07fa8b47f3d97f660)
(cherry picked from commit ddfbdad6bbbad1b92f8cad64582edba93bfd3221)
2023-11-09 21:05:51 +00:00
Antonio Alvarez Feijoo
64b772e127 man/systemd-dissect: various fixes
- Add synopsis to `--discover` and `--validate` options.
- `-l` is for `--list`, not for `--mtree`.

(cherry picked from commit a0582220f5fe4927487bbfd4d56d2c1abd964e4a)
(edited to remove --validate for v253, where it doesn't exist)
(cherry picked from commit 44b29d93c39d826d69734dbab88b94ad56d529b4)
2023-09-28 14:40:43 +01:00
Abderrahim Kitouni
81bb9067b9 man: fix docbook syntax for function docs
This fixes sd_bus_error_add_map and man/sd_uid_get_state

(cherry picked from commit 0ee42394374db269fc85f9cdbe5d7249fee541b3)
(cherry picked from commit 0144678b04c2193bf89e0666e7c0e9f5dce19ffa)
2023-09-28 14:40:43 +01:00
Abderrahim Kitouni
d60ae0b01a man/kernel-command-line: don't refer early_core_pattern to systemd
It is defined later in the same file

(cherry picked from commit d511acdf8257389a4b670c120717e5b6bc224986)
(cherry picked from commit b283661e01dbb5f2de166e0e25bdc01bf0dde4b1)
2023-09-28 14:40:43 +01:00
Antonio Alvarez Feijoo
e730e0ce16 man/kernel-install: document missing $KERNEL_INSTALL_IMAGE_TYPE
Available since https://github.com/systemd/systemd/commit/3d5f0bfe

(cherry picked from commit cb5f21de197c7c2c291637d9234a9373d8b0aee4)
(cherry picked from commit 3e10a49d34654fd1bb6b6b87e5ce540075b535df)
2023-09-28 14:40:43 +01:00
Michael Vasseur
1ab8d21988 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)
2023-09-08 00:45:00 +01:00
Zbigniew Jędrzejewski-Szmek
41a3e30b12 man/gpt-auto-generator: avoid saying "negative" for boolean
Fixes #28928.

(cherry picked from commit 7abb0eef8fe4510e04c365778489af01ad562587)
(cherry picked from commit 9d43d9e8c54933ffda8b9b31948c597ff8fee9de)
2023-09-08 00:45:00 +01:00
Lennart Poettering
4e51e336c8 man: mention two more things logind does
Prompted by: #28902

(cherry picked from commit 1126841553a28f22eb6bc55eeed8af8d98610f71)
(cherry picked from commit bec4bb92e24fd284974a2d9e4e67563da2732cbb)
2023-09-08 00:45:00 +01:00
Rahil Bhimjiani
ef7eedb8c0 man: kernel-install(8) add uki.conf in FILES & add ukify(1) in SEE ALSO
Signed-off-by: Rahil Bhimjiani <rahil3108@gmail.com>
(cherry picked from commit f5263dd09e428df42c3d3b12f7e8ca95121ef3ee)
(cherry picked from commit 0baa4866d5f4b68d5d432ae88ddd73282bafcb07)
2023-09-08 00:45:00 +01:00
Lennart Poettering
495f887e55 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)
2023-09-08 00:45:00 +01:00
Lennart Poettering
bdc79b27ee man: let's tone down the recommendation to use Type=exec a bit
This is a follow-up for #28596.

I think the suggestion to use Type=exec uses too strong wording:
Type=exec has non-trivial drawbacks over Type=simple, and they deserve
to be mentioned.

Hence drop the <emphasis> and turn this around so that Type=exec is
*recommended*, but Type=simple is not expressly discouraged, because
there are plenty reasons to use it.

Add a brief discussion where Type=simple might be preferable.

Also, fix the outright unruth that Type=exec was the "simplest and
fastest", because it certainly is a lot, but not that.

(cherry picked from commit e5e900edcd3b245499379201072cbb69346e9798)
(cherry picked from commit 045ff3b47a2f6611e079cfdaf330366239b38c98)
2023-09-08 00:45:00 +01:00
mordner
6b1a3e05d0 man: fix typo in journalctl
(cherry picked from commit 653c90ec0e6f4d68b68938a20bd8cff492e7a666)
(cherry picked from commit b4b4caf09f2826266fbe70d0de1c6276f2670bd7)
2023-08-09 23:04:43 +01:00
Mike Yuan
4d79082c00 man/systemd.unit: DefaultTimeoutStartSec= -> DefaultDeviceTimeoutSec=
for device unit job timeouts

Follow-up for #24044

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

(cherry picked from commit 000680a68dbdb07d77807868df0b4f978180e4cd)
(cherry picked from commit 9c1b5911af27193bf92780dc231fe523cecf4c24)
2023-08-09 23:04:43 +01:00
Zbigniew Jędrzejewski-Szmek
9449449ef9 man/systemd.service: advise Type=exec instead of Type=simple
The descriptions of various options are reworked: first say what protocol
actually is, i.e. describe what type of notification the manager waits
for. Only after that describe various steps and things the service should
do. Also, apply some paragraph breaks.

Instead of recommending Type=simple, recommend Type=exec. Say explicitly that
Type=simple, Type=forking are not recommended. Type=simple ignores failure in a
way that doesn't make any sense except as a historical accident. We introduced
'exec' instead of changing 'simple' to keep backwards-compatiblity, but
'simple' is not very useful. 'forking' works, but is inefficient: correctly
programming the interface requires a lot of work, and at runtime, the
additional one or two forks are just a waste of CPU resources. Furthermore, we
now understand that because of COW traps, they may also increase memory
requirements. There is really no reason to use 'forking', except if it's
already implemented and the code cannot be changed to use 'notify'.

Also, remove the recommendations to use Type=simple to avoid delaying boot. In
most cases, if the service can support notifications about startup, those
should be done.

Overall, for new services, "notify", "notify-reload", and "dbus" are the
types that make sense.

(cherry picked from commit 377d3a31e638c834ba66edefa4cabc90318420fc)
(cherry picked from commit 3d9be9aa3171d2096ab4922630f4db0a548e570d)
2023-08-09 23:04:43 +01:00
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