Yu Watanabe
005c7b1d88
journal: make namespace invocation also support drop-in config
2021-03-05 06:57:14 +09:00
Lennart Poettering
44a8ad7a24
man: document how to use --network-interface= during boot
...
Fixes : #18793
2021-03-04 18:55:36 +01:00
Xℹ Ruoyao
a70581ffb5
New directives PrivateIPC and IPCNamespacePath
2021-03-04 00:04:36 +08:00
Lennart Poettering
725ad3b062
fstab-generator: add new root=tmpfs option
...
It's useful to be able to combine a regular /usr/ file system with a
tmpfs as root, for an OS that boots up in volatile mode on every single
boot. Let's add explicit support for this via root=tmpfs.
Note the relationship to the existing systemd.volatile= option:
1. The kernel command line "root=/dev/… systemd.volatile=yes" will mount
the specified root fs, and then hide everything at the top by
overmounting it with a tmpfs, except for the /usr subtree.
2. The kernel command line "root=tmpfs mount.usr=/dev/…" otoh will mount
a toot fs at the top (just like the case above), but will then mount
the top-level dir of the fs specified in mount.usr= directly below
it.
Or to say this differently: in the first case /usr/ from the physical
storage fs is going to become /usr/ of the hierarchy ultimately booted,
while in the second case / from the physical storage fs is going to
become /usr of the hierarchy booted.
Philosophically I figure systemd.volatile= is more an option for
"one-off" boots, while root=tmpfs is something to have as default mode
of operation for suitable images.
This is currently hard to test reasonably, since Dracut refuses to
accept root=tmpfs. This needs to be addressed separately though.
2021-03-03 12:16:32 +09:00
Luca Boccassi
7e40042b55
man: document usage of SD_BUS_CREDS_AUGMENT
2021-03-02 12:18:53 +01:00
Lennart Poettering
0498d8d74a
Merge pull request #18841 from keszybz/a-bunch-of-man-page-updates
...
Two minor small man page updates
2021-03-02 11:03:44 +01:00
Yu Watanabe
7a7d2f16c2
tree-wide: fix typo
2021-03-02 09:48:20 +01:00
Zbigniew Jędrzejewski-Szmek
33360f35a1
man: reword sentence about lone coredumps
...
Let's make it clear that they are not as useful as the full thing.
2021-03-02 09:37:49 +01:00
Zbigniew Jędrzejewski-Szmek
c53e8b9de6
man: add note about "SIG" prefix
2021-03-02 09:35:22 +01:00
Zbigniew Jędrzejewski-Szmek
1447d87a47
man: document \u and \U, say that utf-8 is allowed
2021-03-01 20:57:36 +01:00
Zbigniew Jędrzejewski-Szmek
07dc08c269
man: move two sysv-specific variables to docs
...
https://github.com/systemd/systemd/pull/18827#discussion_r584807684
2021-03-01 20:57:36 +01:00
Zbigniew Jędrzejewski-Szmek
40019c32d7
man: clarify what is inside/outside the container in coredump info
2021-03-01 20:57:36 +01:00
Zbigniew Jędrzejewski-Szmek
a1174b2260
man: update link to systemd-coredump-python
...
This got moved under the systemd umbrella a long time ago.
Github redirects from the old path, so the link worked, but it's
nicer to use the real location.
2021-03-01 20:53:57 +01:00
Zbigniew Jędrzejewski-Szmek
cd18afec16
Merge pull request #18827 from keszybz/a-bunch-of-man-page-updates
...
A bunch of man page updates
2021-03-01 15:14:40 +01:00
Zbigniew Jędrzejewski-Szmek
dac05c0808
man: say that machine-info doesn't have to exist
...
Esp. CHASSIS is only useful as an override. Make that clear in the description.
Fixes #3496 .
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
aa2e348d7b
man: tweak descriptions of how tmpfiles should be started
...
We shouldn't imply that invocation without any parameters is OK.
Also, mention that the service can be restarted.
Fixes #8684 .
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
e531091ba0
man: describe quoting and specifiers in Environment=
...
Fixes #10604 .
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
4d729e3796
man: move quoting description to systemd.syntax
...
We use very similar quoting rules in many places. Let's move this
lengthy text out of systemd.service page.
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
36f57e02d7
man: explain how to invoke tmpfiles for debugging
...
Fixes #11914 .
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
5929b6b522
man: mention that != matches nonexistent keys too
...
Fixes #15984 .
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
9479d92ebc
man: reorder match types in udev rules
...
The plural version should always be adjacent to the singular one.
And the plural should not be explained before the singular one…
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
32f82cccea
man: add footnote explaining why "localhost" query is sent out to the network
...
I tried to make the explanation brief, but this isn't so easy. It seems better
to push this out to a footnote instead of the main text.
Fixes #16584 .
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
9273d8e6c9
man: move motivational explanation to footnote
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
fc070a2574
man: describe the syntax for {Job,}{Running,}TimeoutSec=
...
Fixes #16644 .
Also break the text into paragraphs to make it a bit easier to read.
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
09d9081447
man: move description of $SYSTEMD_SYSVINIT_PATH to the only user
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
b4c87f7d38
man: reuse common-variables in systemd(1)
...
This requires a bit of gimnastics, but I think it's still better than
status quo ante, and better than duplicating the text.
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
5bd27a17ca
man: describe various logging configuration variables
...
Fixes #17484 .
This patch affects systemctl(1), as well as all man pages that include
all of common-variables.xml, i.e. most of our command line tools.
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
4ef3ca3447
man: rename less-variables→common-variables
...
Some are not about less, e.g. $SYSTEMD_URLIFY.
2021-03-01 13:40:52 +01:00
Zbigniew Jędrzejewski-Szmek
9d58abfa25
man: describe coredump fields
...
We save a wealth of information about the process, but this might not be
immediately obvious.
2021-03-01 13:40:52 +01:00
Lajos Veres
5773351881
Fix path typo in systemd.unit
...
/etc/systemd/systemd/ => /etc/systemd/system/
2021-03-01 08:45:19 +09:00
Zbigniew Jędrzejewski-Szmek
4f57f77267
man: make systemd-coredump and coredumpctl descriptions more accessible
...
Fixes #17910 : we didn't clearly explain that coredumps may exist without
journal entries, and vice versa.
Also, make the examples more concrete, and use '$' instead of '#' to avoid
suggesting that running as root is required. The text is extended a bit in
various places. In the description of systemd-coredump, the details of executor
separation are split out to a separate subsection, since they are rather
detailed and not necessary to understand for normal use.
2021-02-28 11:29:21 +01:00
Lennart Poettering
fa1ca5f409
Merge pull request #18800 from poettering/network-target-more-doc
...
some improvements regarding network.target docs
2021-02-26 10:59:23 +01:00
Lennart Poettering
85f3bd23da
man: say explicitly that network.target should give the guarantee that synthetic network interfaces have been created
...
Prompted by: #18793
2021-02-26 09:31:11 +01:00
Lennart Poettering
26ac511a7e
man: be more explicit about network-online.target and consuming services of other hosts
...
Let's make things a tiny bit more explicit.
2021-02-26 09:29:52 +01:00
Lennart Poettering
8b596d51a9
man: fix indentation of example
...
The man page otherwise looks very weirdly aligned.
2021-02-26 09:29:52 +01:00
Zbigniew Jędrzejewski-Szmek
34507fa9e9
man: remove details of ManagedOOMPreference implementation
2021-02-25 21:14:04 +01:00
Zbigniew Jędrzejewski-Szmek
a8136f1bc0
man: advertise shared drop-ins more
...
systemd.unit(5) is a wall of text. And this particular feature can be very useful
in the context of resource control. Let's avertise this cool feature a bit more.
Fixes #17900 .
2021-02-25 21:14:04 +01:00
Zbigniew Jędrzejewski-Szmek
4fc8a70d9f
man: fix two issues in udev(7)
...
Fixed #18050 .
2021-02-25 21:14:04 +01:00
Zbigniew Jędrzejewski-Szmek
9f0840e421
man: say that hostname must can be a fqdn or not
...
Fixes #18426
2021-02-25 21:14:04 +01:00
Zbigniew Jędrzejewski-Szmek
c91ebcdbd1
man: explain settings in timesyncd.conf(5)
...
Fixes #18508 .
2021-02-25 21:14:04 +01:00
Zbigniew Jędrzejewski-Szmek
d5630d2795
man: drop misplaced spaces and parenthesization
2021-02-25 21:14:04 +01:00
Zbigniew Jędrzejewski-Szmek
326152af4d
man: use markup more in description of ManagedOOMPreference=
...
Follow-up for d8a4d64bc3
.
2021-02-25 21:14:04 +01:00
Zbigniew Jędrzejewski-Szmek
beca342dba
man: fix grammaro
2021-02-25 14:55:17 +01:00
Zbigniew Jędrzejewski-Szmek
155d626bc6
Merge pull request #18018 from bluca/mount_images_overlay
...
Add ExtensionImages directive to form overlays
2021-02-25 11:31:14 +01:00
Joerg Behrmann
fa02711758
treewide: fix spelling
2021-02-25 05:54:11 +09:00
Annika Wickert
c0267a592a
network: Implement B.A.T.M.A.N. Advanced interface type
2021-02-25 01:57:29 +09:00
Yu Watanabe
b49bb2866c
doc,man: fix-typo (hierachy -> hierarchy)
2021-02-24 09:54:16 +01:00
Zbigniew Jędrzejewski-Szmek
d515864346
man: add a description of how manager env block is set
2021-02-23 17:18:05 +01:00
Luca Boccassi
93f597013a
Add ExtensionImages directive to form overlays
...
Add support for overlaying images for services on top of their
root fs, using a read-only overlay.
2021-02-23 15:34:46 +00:00
Lennart Poettering
3acf00a5a4
man: various improvements to systemd.generator(7)
...
In particular, make clear the .d/*.conf unit file drop-ins are OK to
generate from generators.
Inspired by: https://lists.freedesktop.org/archives/systemd-devel/2021-February/046148.html
2021-02-23 22:44:05 +09:00