5c11632735
man: document the new sd_bus_enqueue_for_read() API call
2020-02-04 18:47:32 +01:00
6bdd90fbcd
man: add "quick-help" to sysusers.d synopsis
...
We have that in tmpfiles.d and it is makes looking up the syntax
very easy.
While at it, add an example for "r" and use the underscrore as prefix
as described in the text.
2020-02-04 18:20:28 +01:00
2979f04b99
Merge pull request #14717 from yuwata/network-radv-dns-link-local
...
network: make DNS= in [IPv6PrefixDelegation] section take special value '_link_local'
2020-02-04 17:47:17 +01:00
ca58d00c68
network: FairQueueTrafficPolicing→FairQueueing
...
This never made into a release, so we can change the name with impunity.
Suggested by Davide Pesavento.
I opted to add the "ing" ending. "Fair queuing" is the name of the general
concept and algorithm, and "Fair queue" is mostly used for the implementation
name.
2020-02-04 17:37:16 +01:00
60ed2dcfc7
network: TokenBufferFilter→TokenBucketFilter
...
This never made into a release, so we can change the name with impunity.
Noticed by Davide Pesavento.
2020-02-04 17:28:15 +01:00
8e92d92fb8
man: tweak description of blockdev@.target
...
In particular, let's just say "is" and "must" instead of "may be" and
"should". The weaker forms are obviously correct, but the text is easier to
understand if non-conditional forms are used.
2020-02-04 16:40:52 +01:00
dc9fd22d3d
Merge pull request #14398 from poettering/mount-prep
2020-02-04 16:28:51 +01:00
18de0969c5
network: split TrafficControlQueueingDiscipline section into small pieces
...
Closes #14763 .
2020-02-04 21:45:39 +09:00
fd3ef936ed
network,radv: make DNS= in [IPv6PrefixDelegation] section take special value 'linklocal'
...
Closes #13639 .
2020-02-04 13:56:30 +09:00
2f1fc899ce
Merge pull request #14589 from keszybz/sysctl-downgrade-messages
...
sysctl: add glob patterns to set network settings more flexibly
2020-02-04 00:04:28 +01:00
e0f424790d
sysctl: add glob syntax to sysctl.d files
...
This is intended for net.*.conf.*.foo files. Setting just "default" is not very
useful because any interfaces present before systemd-sysctl is invoked are not
affected. Setting "all" is too harsh, because the kernel takes the stronger of
the device-specific setting and the "all" value, so effectively having a weaker
setting for specific interfaces is not possible. Let's add a way in which can
set "default" first and then all the others without "all".
2020-02-04 00:01:50 +01:00
bf2334c054
udev: add {Receive,Transmit}ChecksumOffload= settings
...
Closes #14661 .
2020-02-03 12:31:31 +09:00
53e1ba280f
network: add SuppressPrefixLength option to RoutingPolicyRule ( #14736 )
...
Closes #14724 .
2020-02-03 08:25:48 +09:00
d58f31793a
Merge pull request #14645 from keszybz/sd-bus-message-dump
...
sd_bus_message_dump
2020-02-02 17:27:50 +01:00
649916d356
sysusers: support creating users with a specific primary group
...
This extends the "uid:gid" syntax for "u" lines so that a group
name can be given instead of a GID. This requires that the group
is either queued for creation by sysusers, or it is already defined
on the system.
Closes #14340
2020-02-02 16:53:22 +01:00
ea471a4695
network: support UID based routing policy
...
Closes #14666 .
2020-02-02 22:43:38 +09:00
af06ddf51a
meson, man: do not install pam_systemd_home(8) when pam or homed is disabled
...
Fixes #14725 .
2020-02-01 12:13:45 +01:00
2b6b8bd3f7
man: document --namespace= switch of journalctl
2020-01-31 15:10:40 +01:00
241c8f67f6
man: document the new sd_journal_open_namespace() API
2020-01-31 15:10:40 +01:00
5b0a76d107
man: document LogNamespace= unit setting
2020-01-31 15:10:40 +01:00
7d8155b3df
man: document new _NAMESPACE= journal field
2020-01-31 15:10:40 +01:00
6bc4361997
man: document journald@NAMESPACE.conf
2020-01-31 15:10:40 +01:00
efcbcd0d04
man: document journald namespaces
2020-01-31 15:10:40 +01:00
2d37ea5ca9
man: do not install man pages for systemd-repart if it is disabled
...
Closes #14716 .
2020-01-31 18:06:09 +09:00
f770b7e084
man: document man/sd_bus_message_dump.xml
2020-01-30 14:33:05 +01:00
2a4be3c52b
Various typo fixes and grammar corrections
2020-01-30 13:48:01 +01:00
02d89f9a62
man: add syntax quickhelp to sysctl.d(5)
2020-01-30 10:48:50 +01:00
fa2111bd3e
man: document logging downgrade in systemctl
...
Fixup for 32458cc968
2020-01-30 10:48:35 +01:00
28e208a7d8
man: document pam_systemd_home
2020-01-28 22:37:49 +01:00
38e7b808eb
man: add systemd-homed man page
2020-01-28 22:37:25 +01:00
ea7a19e95d
man: add homectl(1) man page
2020-01-28 22:37:00 +01:00
7d20404816
Merge pull request #14685 from poettering/sd-bus-bool-as-int
...
sd-bus documentation: highlight bool vs. int situation
2020-01-28 17:57:30 +01:00
b940fb1f4f
Merge pull request #14594 from keszybz/id128-show-gpt
...
Print gpt table values in systemd-id128
2020-01-28 17:23:50 +01:00
e0db55a643
man: document that sd_bus_message_read_array() only supports trivial types
...
Fixes : #14641
2020-01-28 16:52:15 +01:00
10c238b2cc
man: clarify that we decode D-Bus bools as "int", not as C99 "bool"
...
Fixes : #14643
2020-01-28 16:38:53 +01:00
e5667705fa
man: describe types slightly more accurately
2020-01-28 16:38:38 +01:00
979bdc47c9
man: enclose C type names in <type></type>
2020-01-28 16:37:57 +01:00
766840af42
Merge pull request #14673 from keur/protect_clock
...
Protect clock
2020-01-28 15:11:41 +01:00
022d334561
man: doc: Document ProtectClock=
2020-01-27 11:21:36 -08:00
0de6103dff
man: tmpfiles.d: list missing q
...
Also, Q creates directories (same as v), so update the example
accordingly.
2020-01-26 13:32:00 +09:00
da2076a159
man: remove duplicate in list of variables ignored by Anonymize
...
SendHostname= appears twice in the list of variables ignored by
Anonymize=.
2020-01-25 11:54:53 +09:00
dc972b0740
systemd-id128: add new verb to print GPT partitions UUIDs
2020-01-23 23:32:13 +01:00
5e176a4dee
Merge pull request #14368 from poettering/repart
2020-01-23 19:07:02 +01:00
68bda079fd
man: document blockdev@.target
2020-01-21 20:23:47 +01:00
fbbe240b21
Merge pull request #14605 from aerusso/pulls/x-systemd-wantedby-requiredby
...
Implemented x-systemd.{required,wanted}-by= options
2020-01-21 19:21:49 +01:00
a15e1a5df0
man: fix typo in systemd.netdev Xfrm example
...
The first section header in that example should probably be `[NetDev]` and not `[Xfrm]`.
2020-01-21 18:57:57 +01:00
be02c1cf42
Implemented x-systemd.{required,wanted}-by= options
...
Teaches systemd-fstab-generator these two unit options,
creating appropriate dependencies on the generated .mount
units. When used, they override any other automatically
generated dependencies, such as local-fs.target, and are
NOT suppressed by noauto. The new options are ignored for
/, in the same way that noauto is ignored.
Fixes : #14380
Signed-off-by: Antonio Russo <antonio.e.russo@gmail.com>
2020-01-21 06:54:34 -07:00
81248e7f3e
Documentation update for x-systemd.{before,after}
...
A minor clarification in the manual page is made.
Signed-off-by: Antonio Russo <antonio.e.russo@gmail.com>
2020-01-20 21:05:08 -07:00
917cc8082b
man: document systemd-repart
2020-01-20 17:42:03 +01:00
5cbaf95ee3
wait-online: Support waiting for interfaces to disappear
2020-01-18 18:17:25 +01:00
75cd4a5d92
wait-online: Add maximum operational state option
2020-01-18 18:17:22 +01:00
f535af6bcd
man: document that WakeSystem= affects clock choice
...
Fixes : #8308
2020-01-17 10:09:50 +01:00
54ed193f8d
man: clarify that user rlimits cannot go beyond limits set for service mgr
...
Fixes : #10758
2020-01-17 10:09:50 +01:00
59d83463d1
man: extend on halt documentation
...
Based on the suggestions on #13254 and #13264
Fixes : #13254
2020-01-17 10:08:23 +01:00
0b306655f1
man: document that rootflags= does not override /etc/fstab
...
Fixes : #13324
2020-01-17 10:08:23 +01:00
d524094b6b
man: underline that AccuracySec= is about coalescing timer events, nothing else
...
Fixes : #13328
2020-01-17 10:08:23 +01:00
eec68a1a08
man: mention that Before= doesn't work for device units
...
Fixes : #13362
2020-01-17 10:08:13 +01:00
49dd0c161a
man: suggest SYSTEMD_WANTS usage instead of RUN for long running processes
...
Fixes : #14259
2020-01-17 10:08:13 +01:00
f27a21d48b
man: document the limits of the block device discovery for IO cgroup options
...
Fixes : #14271
2020-01-17 10:08:13 +01:00
1e8a7eff22
man: document how error propagation to path units works
...
Fixes : #14331
2020-01-17 10:08:13 +01:00
ba96a8a277
man: document that program invocation will fail if the User= does not exist
...
Fixes : #14565
2020-01-17 10:08:13 +01:00
5c1a9ef088
Merge pull request #14585 from keszybz/sysctl-downgrade-messages
...
Downgrade sysctl message to log_debug in containers
2020-01-16 18:45:29 +01:00
c97ae2b290
Clarify journald.conf MaxLevelStore documentation
...
'stored on disk' gives the impression that this option affects only
permanent storage, even though it affects everything the journal
records, regardless of the storage type.
Use 'stored in the journal' to avoid confusion.
2020-01-16 18:41:33 +01:00
e76c60bf2a
man: rework section about configuration file precedence
...
This section is loaded in a bunch of places, so this affects many
man pages.
1. point the reader to the synopsis section, which has the exact paths
that are used to load files.
2. put the "reference" part first, and recommendations later, in separate
paragraphs.
3. describe how individual settings and whole files are replaces.
Closes #12791 .
2020-01-16 14:45:37 +01:00
0ba56d3657
man: document the new nss-systemd behaviour
...
(This also changes the suggested /etc/nsswitch.conf line to use for
hooking up nss-system to use glibc's [SUCCESS=merge] feature so that we
can properly merge group membership lists).
2020-01-15 15:31:00 +01:00
7d9ad0e5e5
man: document systemd-userdbd.service
2020-01-15 15:30:40 +01:00
3b2db6f110
man: document userdbctl(1)
2020-01-15 15:30:20 +01:00
fc89f88e56
man: document new pam_systemd features in man page
...
This also updates the suggested PAM snippet in a number of way:
1. Be closer to the logic nowadays implemented in Fedora where the
auth/account/password stacks are all finished off with
pam_{deny|permit}.so
2. Make pam_unix.so just "sufficient" instead of "required" (paving
ground for pam_systemd_home.so being hooked in as additional
sufficient module.
3. Only do pam_nologin in the "account" stack, since it's about account
validity really.
4. Use modern parameters to pam_unix when changing passwords, i.e.
sha512 and shadow, and use already set up passwords (preparing ground
for pam_systemd_home again)
2020-01-15 15:30:06 +01:00
d00386fc0b
man: add commas and reword a sentence
...
On more careful reading, "exit status ... do not cause the unit to enter a
failure state" is not gramatically or logically correct.
2020-01-15 08:57:37 +01:00
550979c8ae
Merge pull request #14570 from keszybz/resource-docs
...
Modernize links to cgroups docs
2020-01-14 16:17:38 +01:00
ea7fe1d1c2
Merge pull request #14390 from poettering/gpt-var-tmp
...
introduce GPT partition types for /var and /var/tmp and support them for auto-discovery
2020-01-14 15:37:53 +01:00
7c286cd6a6
Merge pull request #14505 from poettering/refuse-on-failure
...
refuse OnFailure= deps on units that have no failure state
2020-01-14 14:19:04 +01:00
ab1b472062
Merge pull request #14555 from poettering/table-multine
...
format-table: proper multi-line support
2020-01-14 06:48:57 +09:00
765d88698f
Merge pull request #14400 from keszybz/alias-check
...
Alias check rework
2020-01-13 18:03:13 +01:00
0b9da3d9e8
Merge pull request #14293 from keur/systemctl_with_dependencies
...
systemctl: Add --with-dependencies switch
2020-01-13 17:42:55 +01:00
03f9228e7c
man: suffix parameter with = in our documentation, if it expects an argument
...
Also, don't claim we'd insert a "," between addresses, because we
actually don't do that.
2020-01-13 16:38:44 +01:00
f9951b0cf0
man: we support bind mounting regular files too
...
Let's be precise here: we accept non-directories here too, even though
we create things as directories if we find the Where= not to exist.
2020-01-13 11:24:35 +01:00
151a7133cd
man: document that we mkdir() on What= in .mount units too
...
As suggested here:
https://lists.freedesktop.org/archives/systemd-devel/2020-January/043914.html
2020-01-13 11:23:59 +01:00
6b8fe4c30c
man: XxxRate= are in bps
2020-01-12 10:11:07 +01:00
2e93770fd8
man: document alias rules and aliases dropin loading
2020-01-10 14:31:28 +01:00
12845a91b5
machinectl: do not truncate addresses when --full is specified
2020-01-10 19:19:15 +09:00
a602a0b44b
man: Document systemctl --with-dependencies switch
2020-01-09 22:58:00 -08:00
a65e34ccb0
machinectl: do not ellipsize table when --full is specified
2020-01-10 12:24:51 +09:00
b683b82fe7
busctl: introduce --full command line option
2020-01-10 12:19:47 +09:00
a42d949080
networkctl: set table width 0 when --full is specified
2020-01-10 12:12:00 +09:00
a362c069a9
systemd-mount: add --full command line option
2020-01-10 12:07:28 +09:00
b63c88b627
man: describe "symlink" and "systemctl link" explicitly in UNIT FILE LOAD PATH
...
There are sometimes users who put unit files in a location that is inaccessible
when systemd starts although they are not found and thus not started because
the corresponding mount units have not activated yet.
There is already a warning for such issue in man 8 systemctl:
link PATH...
...<snip>...
The file system where
the linked unit files are located must be accessible
when systemd is started (e.g. anything underneath /home
or /var is not allowed, unless those directories are
located on the root file system).
However, it looks that it's difficult to find the warning because introductory
users typically doesn't know systemctl link.
Although there is a description in UNIT FILE LOAD PATH pointing to systemctl
link, symlink is now not explicitly mentioned there and thus users doesn't
easily get aware of they should read it.
To deal with this, let's describe "symlink" and "systemctl link" more
explicitly in UNIT FILE LOAD PATH.
2020-01-09 18:52:13 +01:00
246be82bd4
man: link to specific sections of cgroups-v2 document
...
The document is rather huge, and a specific link is easier to consume. The form
is a bit strange because troff puts the symlink at the bottom, keyed by title,
so we need to use the same link target in all places.
2020-01-09 16:47:34 +01:00
bb6d563a50
doc: link to html versions of cgroup docs
...
Also stop linking to some (obsolete) v1 documentation.
2020-01-09 16:47:34 +01:00
a5279634c0
systemd-mount: add --no-legend command line option
2020-01-09 20:16:03 +09:00
ab015b13df
man: small casing fix
2020-01-09 11:04:41 +01:00
f2e5e70410
man: document that scope units can fail, but not due to process exit statusses
...
Let's clarify that scope units can fail, but not due to process exit
statusses.
This hopefully clears up some confusion that manifested in #14142 : scope
units can fail, but for other reasons than assumed there.
Fixes : #14142
2020-01-09 11:04:27 +01:00
125c7814fa
Merge pull request #14523 from keszybz/refactorings
...
Refactorings inspired by recent pull requests
2020-01-09 12:50:11 +09:00
0aa9bffe10
Merge pull request #14448 from yuwata/network-permanent-mac-address
...
network, udev: support permanent mac address
2020-01-08 15:36:27 +01:00
3bfcfcf942
Merge pull request #14518 from keszybz/interface-text
...
doc: tweak grammar in CONTAINER_INTERFACE description
2020-01-08 14:26:33 +01:00
48dfa8b0e1
Merge pull request #14512 from poettering/root-image-devices
...
Make RootImage= work reliable with DeviceAllow= in the mix
2020-01-08 12:18:38 +01:00
d9b204544b
man: use xi:include to avoid duplication
...
... and fix some unwarranted discrepancies between the two man pages.
2020-01-08 11:43:09 +01:00
629548c405
Merge pull request #14488 from yuwata/networkctl-show-logs
...
networkctl: status command also shows logs of networkd
2020-01-08 10:49:39 +01:00
9552209292
man: fix option name
2020-01-08 10:39:44 +01:00
af6a2a1e57
Merge pull request #14494 from poettering/container-interface
...
Let's import the container interface description text from the fdo wiki
2020-01-08 09:58:57 +01:00
Lennart Poettering