summaryrefslogtreecommitdiffstats
path: root/man (follow)
Commit message (Collapse)AuthorAgeFilesLines
* network: allow to set Group=0 in [Link] sectionYu Watanabe2021-05-251-4/+4
| | | | | | | Previously, when a link has already in a numbered group, we cannot remove the link from the group. This also fixes the range mentioned in the man page.
* man: we is OK too -> which is OK too (#19708)наб2021-05-241-1/+1
|
* network: IPv6LinkLocalAddressGenerationMode=none disables IPv6LL addressingYu Watanabe2021-05-231-5/+9
|
* Merge pull request #19700 from keszybz/check-os-release-fixupsLuca Boccassi2021-05-232-7/+14
|\ | | | | Fixups for man/check-os-release.*
| * man/check-os-release.*: allow ID_LIKE to have multiple valuesZbigniew Jędrzejewski-Szmek2021-05-222-3/+3
| | | | | | | | I missed the fact that it is documented to be a space-separated list.
| * man/check-os-release.py: ignore comment and empty linesZbigniew Jędrzejewski-Szmek2021-05-221-4/+11
| | | | | | | | Plus fix off-by-one in error printing.
* | Merge pull request #19686 from keszybz/os-release-modernization-and-examplesLennart Poettering2021-05-224-313/+381
|\| | | | | os-release modernization and examples
| * man/check-os-release.py: strip trailing whitespaceZbigniew Jędrzejewski-Szmek2021-05-221-1/+1
| | | | | | | | The shell parser would do that, so so should we.
| * man: say that initrd-release is like os-releaseZbigniew Jędrzejewski-Szmek2021-05-222-1/+16
| |
| * man: reword description of BUILD_ID in os-releaseZbigniew Jędrzejewski-Szmek2021-05-211-6/+14
| | | | | | | | | | | | | | Our description was pretty hard to parse. Let's replace it with a description loosely based on a fairly clear description written by a distro that actually uses BUILD_ID: https://developer.rigado.com/docsets/Working-with-the-Rigado-Vesta-Gateway/latest/production/versioning-images.html#the-rigos-scheme.
| * man: add example os-release mangling in pythonZbigniew Jędrzejewski-Szmek2021-05-212-0/+36
| | | | | | | | | | | | | | This is also not entirely obvious. I think the code I came up with is pretty elegant ;] The final part of of the code that makes use of the parsed data is kept very similar to the shell code on purpose, even though it could be written a bit more idiomatically.
| * man: add an example how to correctly read os-release in shellZbigniew Jędrzejewski-Szmek2021-05-212-5/+26
| | | | | | | | | | | | | | This is not entirely obvious. The logic of how to interpret the fields applies in any language, so drop the pointless mention of C or shell.
| * man: reorder fields in os-releaseZbigniew Jędrzejewski-Szmek2021-05-211-309/+297
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Let's order the fields from the most general to least: os name, os variant, os version, machine-parseable version details, metadata, special settings. I added section headers to roughly group the settings. The division is not strict, because for example CPE_NAME also includes the version, and PRETTY_NAME may too, but it still makes it easier to find the right name. Also split out Examples to separate paragraphs: almost all descriptions had "Example:" at the end, where multiple examples were listed. Splitting this out to separate paragraphs makes the whole thing much easier to read. Add missing markup and punctuation while at it. About - If not set, defaults to <literal>NAME=Linux</literal>. + If not set, a default of <literal>NAME=Linux</literal> may be used. and similar changes: in many circumstances, if this is not set, no value should be used. The fallback mostly make sense when we need to present something to the user. So let's reword this to not imply that the default is necessary.
* | network: nexthop: add Group= setting to configure multipath route with group ↵Yu Watanabe2021-05-211-0/+13
| | | | | | | | nexthop
* | man: prevent race condition when generating systemd.directives.xmlasavah2021-05-201-0/+1
| |
* | Merge pull request #19605 from yuwata/network-fdb-outgoing-interfaceLennart Poettering2021-05-201-0/+7
|\ \ | | | | | | network: bridge-fdb: add support to specify outgoing interface
| * | network: bridge-fdb: add support to specify outgoing interfaceSusant Sahani2021-05-201-0/+7
| |/
* / man: mention that drop-in files are merged in alphanumeric orderYu Watanabe2021-05-204-17/+20
|/ | | | This addresses the request in https://github.com/systemd/systemd/issues/19467#issuecomment-829332877.
* man: document default rlimitsAnita Zhang2021-05-202-1/+18
| | | | Fixes #19645
* man: document new nspawn --bind-user= featureLennart Poettering2021-05-192-0/+62
|
* man: describe overall online status in networkctl(1)Alvin Šipraga2021-05-191-8/+40
|
* man: clarify RequiredFamilyForOnline= behaviour for online stateAlvin Šipraga2021-05-191-7/+7
| | | | | | With new "online state" semantics in networkd, make the description of RequiredFamilyForOnline= a little more broad. Some rewording has been done to make the passage easier to understand.
* man: clarify RequiredForOnline= behaviour for online stateAlvin Šipraga2021-05-191-3/+3
| | | | | With new "online state" semantics in networkd, make the description of RequiredForOnline= a little more broad.
* Merge pull request #19611 from ↵Yu Watanabe2021-05-191-0/+8
|\ | | | | | | | | yuwata/network-dhcp-server-introduce-server-address network: dhcp-server: introduce ServerAddress= setting
| * network: dhcp-server: introduce ServerAddress= settingYu Watanabe2021-05-181-0/+8
| | | | | | | | | | This may be useful when the link which DHCP server running on has multiple static addresses.
* | man: use readable names for entitiesZbigniew Jędrzejewski-Szmek2021-05-194-15/+15
| | | | | | | | Let's use the same names as in the jinja2 substitutions.
* | meson: drop "_YES_NO" variablesZbigniew Jędrzejewski-Szmek2021-05-191-2/+2
| | | | | | | | We can generate the right string in the template directly.
* | meson: use jinja2 also for custom-entities.entZbigniew Jędrzejewski-Szmek2021-05-192-19/+19
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This doesn't matter too much, but makes things a bit more consistent. A minor advantage is that the file is not a configuration file for meson anymore, so: a) It is not built unless pulled in by another target. Since we don't usually build man pages by default, this saves a tiny amount of work. b) When the .in file is updated, meson does not reconfigure everything, but just rebuilds the dependent targets. Now that the conversion is finished, time for benchmarking: a full build with default settings (and -Dstandalonebinaries=true), yields before this pull request: 1687 targets, 148.13s user 35.17s system 317% cpu 57.697 total with the full pull request: 1714 targets, 143.07s user 27.87s system 314% cpu 54.369 total The difference doesn't seem significant. Partial rebuilds might be faster as mentioned before.
* | meson: use custom configuration_data() object for man/man and man/html helpersZbigniew Jędrzejewski-Szmek2021-05-191-2/+5
|/ | | | | | | | | | I want to stop using 'substs'. But in this case, configure_file() is nicer than custom_target(), because it causes meson to immediately generate the helpers after configuration, so it's possible to do 'meson build && build/man/man ...', without building anything first. We only substitute one variable here, so let's use a custom configuration_data() object.
* man: only the system manager does not pass vars in ManagerEnvironment=Anita Zhang2021-05-181-4/+4
| | | | | | | User managers always pass their environment on to their children. Make that clear in the description of ManagerEnvironment= which states that none of those args will get passed to child processes of service managers.
* Fixed a typoei-ke2021-05-161-1/+1
|
* Add crypttab option silentSebastian Blunt2021-05-151-0/+7
| | | | | | Adds a crypttab option 'silent' that enables the AskPasswordFlag ASK_PASSWORD_SILENT. This allows usage of systemd-cryptsetup to default to silent mode, rather than requiring the user to press tab every time.
* Merge pull request #19612 from keszybz/meson-0.58-quietingZbigniew Jędrzejewski-Szmek2021-05-151-5/+4
|\ | | | | Make meson output quiet again
| * meson: call find_program() once and reuse the variable everywhereZbigniew Jędrzejewski-Szmek2021-05-141-5/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Meson 0.58 has gotten quite bad with emitting a message every time a quoted command is used: Program /home/zbyszek/src/systemd-work/tools/meson-make-symlink.sh found: YES (/home/zbyszek/src/systemd-work/tools/meson-make-symlink.sh) Program sh found: YES (/usr/bin/sh) Program sh found: YES (/usr/bin/sh) Program sh found: YES (/usr/bin/sh) Program sh found: YES (/usr/bin/sh) Program sh found: YES (/usr/bin/sh) Program sh found: YES (/usr/bin/sh) Program xsltproc found: YES (/usr/bin/xsltproc) Configuring custom-entities.ent using configuration Message: Skipping bootctl.1 because ENABLE_EFI is false Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Message: Skipping journal-remote.conf.5 because HAVE_MICROHTTPD is false Message: Skipping journal-upload.conf.5 because HAVE_MICROHTTPD is false Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Message: Skipping loader.conf.5 because ENABLE_EFI is false Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) Program ln found: YES (/usr/bin/ln) ... Let's suffer one message only for each command. Hopefully we can silence even this when https://github.com/mesonbuild/meson/issues/8642 is resolved.
* | Merge pull request #19609 from keszybz/networkd-dhcp-manLennart Poettering2021-05-141-250/+269
|\ \ | | | | | | Tweak man page ordering for DHCPv[46] options
| * | man: reword descriptions of two DHCPv4 optionsZbigniew Jędrzejewski-Szmek2021-05-141-5/+5
| | |
| * | man: reorder items in [DHCPv4] and [DHCPv6] sectionsZbigniew Jędrzejewski-Szmek2021-05-141-250/+269
| |/ | | | | | | | | | | | | | | The settings were listen in a completely random order, also different between the v4 and v6 sections. Order by "options sent", "options received", "communication settings" in both sections. Also minor formatting changes are done, e.g. "=" is added in various places.
* / networkctl: introduce --json option for "status" and "list" commandsYu Watanabe2021-05-141-0/+1
|/ | | | | | When `--json` option is specified, "status" and "list" commands gives the same information, as originally "list" just gives partial information of "status" in different format.
* Merge pull request #19567 from poettering/ipv4-ipv6-lowercaseZbigniew Jędrzejewski-Szmek2021-05-121-3/+3
|\ | | | | various follow-ups to socket-bind logic
| * socket-bind: use lowercase "ipv4"/"ipv6" spellingLennart Poettering2021-05-111-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | In most of our codebase when we referenced "ipv4" and "ipv6" on the right-hand-side of an assignment, we lowercases it (on the left-hand-side we used CamelCase, and thus "IPv4" and "IPv6"). In particular all across the networkd codebase the various "per-protocol booleans" use the lower-case spelling. Hence, let's use lower-case for SocketBindAllow=/SocketBindDeny= too, just make sure things feel like they belong together better. (This work is not included in any released version, hence let's fix this now, before any fixes in this area would be API breakage) Follow-up for #17655
* | pam: fix typo try_authtok → use_authtokLennart Poettering2021-05-122-2/+3
|/ | | | | | | | This was a copy/paste mistae apparently, there's not "try_authtok" and this was supposed to copy what Fedora uses, which uses "use_authtok" correctly. Hence adjust this. Fixes: #19369
* bootctl: extend --make-machine-id-directory= documentation a bitLennart Poettering2021-05-111-9/+19
| | | | | | | | | | | The directory might not be created in the ESP but in the extended boot loader partition, hence don#t claim otherwise. Also, give a brief reason why the concept exists at all. Link up machine-id man page. Follow-up for: 6a3fff75baad94d9ebff1a6c7d1fb35448c44a81
* man: remove some trailing whitespaceLennart Poettering2021-05-103-6/+6
|
* man: document new userdbctl featuresLennart Poettering2021-05-101-1/+36
|
* man: document new userdbd featuresLennart Poettering2021-05-101-7/+11
|
* man: update nss-systemd documentation with new featuresLennart Poettering2021-05-101-0/+43
|
* Merge pull request #19556 from lucasrangit/network-wifi-interface-type-typosZbigniew Jędrzejewski-Szmek2021-05-101-1/+4
|\ | | | | network: update documentation and examples to use correct interface type and lookup command
| * man: network: use `networkctl list` instead of `status` to list network ↵Lucas Magasweran2021-05-101-1/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | interface type To determine the network interface type for use in the `Type=` directive, it is more concise to use the `list` command. Whereas, the `status` command requires an interface parameter. For example, on a RaspberryPi 4 the following shows that the `wlan0` interface type `wlan` is more coveniently listed by the `list` command. ``` root@raspberrypi4-64:~# networkctl list IDX LINK TYPE OPERATIONAL SETUP 1 lo loopback carrier unmanaged 2 eth0 ether routable configured 3 wlan0 wlan off unmanaged 3 links listed. ``` Whereas the `networkctl status` command doesn't include this information. ``` root@raspberrypi4-64:~# networkctl status ● State: routable Address: 192.168.1.141 on eth0 fd8b:8779:b7a4::f43 on eth0 fd8b:8779:b7a4:0:dea6:32ff:febe:d1ce on eth0 fe80::dea6:32ff:febe:d1ce on eth0 Gateway: 192.168.1.1 (CZ.NIC, z.s.p.o.) on eth0 DNS: 192.168.1.1 May 07 14:17:18 raspberrypi4-64 systemd-networkd[212]: eth0: Gained carrier May 07 14:17:19 raspberrypi4-64 systemd-networkd[212]: eth0: Gained IPv6LL May 07 14:17:19 raspberrypi4-64 systemd-networkd[212]: eth0: DHCPv6 address fd8b:8779:b7a4::f43/128 timeout preferred -1 valid -1 May 07 14:17:21 raspberrypi4-64 systemd-networkd[212]: eth0: DHCPv4 address 192.168.1.141/24 via 192.168.1.1 ``` To get the interface type using the `status` command you need to specify an additional argument. ``` root@raspberrypi4-64:~# networkctl status wlan0 ● 3: wlan0 Link File: /lib/systemd/network/99-default.link Network File: n/a Type: wlan State: off (unmanaged) Path: platform-fe300000.mmcnr Driver: brcmfmac HW Address: dc:a6:32:be:d1:cf (Raspberry Pi Trading Ltd) MTU: 1500 (min: 68, max: 1500) QDisc: noop IPv6 Address Generation Mode: eui64 Queue Length (Tx/Rx): 1/1 ```
* | Wider range of options for selecting entries for systemd-journal-gatewaydSamuel BF2021-05-101-0/+37
|/ | | | | Introducing --user, --system, --merge and --file flags, like for journalctl and systemd-journal-upload.
* Merge pull request #19545 from poettering/nss-systemd-shadowLennart Poettering2021-05-104-6/+13
|\ | | | | nss-systemd: also expose shadow/gshadow entries from userdb records