docs: Add some notes about managing graphical user sessions

This is work in progress and not finished yet. However, I hope to have
captured some of the key points that came up in previous discussions
with appropriate notes about things that still need to be defined.

I may revisit it later. Also, feel free to completely rewrite if the
format is not quite right.

hwdb: add Star Lite Mk II and Star LabTop Mk III (#14621)

Add Lenovo IdeaPad Miix 300 ACCEL_MOUNT_MATRIX

user-util: Allow names starting with a digit

In 1a29610f5fa1bcb2eeb37d2c6b79d8d1a6dbb865 the change inadvertedly
disabled names with digit as the first character. This follow-up change
allows a digit as the first character in compat mode.

Fixes: #15141

core/unit: print info when unit_add_name failed

When there are hundreds of mounts on the server, it will take a long
time to analyze the failure of a certain mount unit. So it is useful
to print the reason why unit_add_name() failed.

Remove stale doc about PrivateNetwork and type

systemd-network-generator.service: network-pre.target is a passive target unit

Add `shell` to machinectl ZSH completion

Merge pull request #15186 from DaanDeMeyer/clangd-fix-wstring-plus-int

Silence Wstring-plus-int warning when using clangd with GCC.

Merge pull request #15236 from ssahani/br-follow-up

shared- bride util allign bridge_state_table

shared- bride util allign bridge_state_table

po: update Ukrainian translation (#15228)

Merge pull request #15224 from ssahani/geneve

networkctl: Display more geneve properties

path-lookup: Use default value for XDG_CONFIG_DIRS if environment is not set

If XDG_CONFIG_DIRS is unset, the specification says we should assume
/etc/xdg.

Merge pull request #15214 from ssahani/networkctl-br1

network: Introduce bridge util

Merge pull request #15170 from keszybz/sd-bus-resolve-magic

sd-bus: resolve SD_BUS_DEFAULT_* in more places

Merge pull request #15209 from anitazha/moar-cgroup-utils

cgroup-utils: convenience helpers

Merge pull request #15191 from GiedriusS/feature/list-unit-files-return-1

systemctl: exit with 1 if no unit files found

systemctl: exit with 1 if no unit files found

Add a simple check on the number of unit files that were found: return
`-ENOENT` when none is found from the function and thus `systemctl`
consequently exits with `1` (`EXIT_FAILURE`) if none were found.

Verification:
```bash
root@image:~# systemctl list-unit-files dbus-nonexistant.service; echo
$?
UNIT FILE STATE VENDOR PRESET

0 unit files listed.
1
root@image:~# systemctl list-unit-files dbus.service; echo $?
UNIT FILE    STATE  VENDOR PRESET
dbus.service static enabled

1 unit files listed.
0
```

Fixes #15082.

networkctl: Display more geneve preperties

network: Introduce geneve util

cgroup-util: cg_get_xattr_malloc helper

`cg_get_xattr_malloc` to read a cgroup xattr value and allocate space
to hold said value (simple helper combining existing functions).

cgroup-util: helper to cg_get_attribute and convert to uint64_t

A common pattern in the codebase is reading a cgroup memory value
and converting it to a uint64_t. Let's make it a helper and refactor a
few places to use it so it's more concise.

network: attach sd-event in link_load() when creating link dhcp_client or ipv4ll

Commit 08c588d18b1e337f856e6541f3f711be48718279 moved attachment of the
sd-event into creation of the dhcp_client or ipv4ll in dhcp4_configure()
or ipv4ll_configure(), but these can also be created in link_load(),
so that creation needs to also perform sd-event attachment.

Without this, dhcp_client or ipv4ll created in link_load() will not have
an ->event and will fail assertion, causing networkd to fail, e.g.:

Assertion 'client->event' failed at src/libsystemd-network/sd-dhcp-client.c:1283, function client_start_delayed(). Ignoring.
ens2: Could not acquire DHCPv4 lease: Invalid argument
ens2: Failed

networkctl: Use string table for bridge state

shared: Introduce bridge util

networkctl: Add more bridge properties

Merge pull request #15185 from ssahani/fix-sip-copy-paste

network: DHCP lease load SIP copy paste error

davfs is a network file system

Fall back to kexec when no kexec binary exists

This may be not a popular setup, but in case kexec resides somewhere different
than the default location for KEXEC (`/usr/sbin/kexec`), don't just reboot and
try doing `reboot(RB_KEXEC)` instead, just like what `kexec -e` normally does.

units: Don't mount tracefs in LXC

Mounting tracefs fails in unprivileged LXC containers and latest LXD
(3.23) bind mounts tracefs already.

Fixes https://github.com/lxc/lxd/issues/7059

swap: check p->what for NULL

Commit 61f9cf4e4c introduced swap_get_parameters(s) but only
checked its return for NULL and not its ->what.

Fixes https://github.com/systemd/systemd/issues/15070

man: fix typo in loader.conf(5)

sd-bus: Add sd_bus_send docs + cleanups.

networkctl: Add support to display SIP servers

```
❯ build/networkctl status veth99                                                                                                                                                           ─╯
● 17: veth99
                     Link File: /usr/lib/systemd/network/99-default.link
                  Network File: /usr/lib/systemd/network/veth99.network
                          Type: ether
                         State: routable (configured)
                        Driver: veth
                    HW Address: 1e:04:f8:b8:2f:d4
                           MTU: 1500 (min: 68, max: 65535)
                         QDisc: noqueue
  IPv6 Address Generation Mode: eui64
          Queue Length (Tx/Rx): 1/1
              Auto negotiation: no
                         Speed: 10Gbps
                        Duplex: full
                          Port: tp
                       Address: 192.168.5.35 (DHCP4)
                                fe80::1c04:f8ff:feb8:2fd4
                       Gateway: 192.168.5.1
                           DNS: 192.168.5.1
                           NTP: 192.168.5.1
                           SIP: 192.168.5.4
                                192.168.5.5
                     Time Zone: Europe/Berlin

Mar 21 23:26:32 Zeus systemd-networkd[671]: veth99: Link DOWN
Mar 21 23:26:32 Zeus systemd-networkd[671]: veth99: Lost carrier
Mar 22 10:25:35 Zeus systemd-networkd[671]: veth99: Link UP
Mar 22 10:25:35 Zeus systemd-networkd[671]: veth99: Gained carrier
Mar 22 10:25:36 Zeus systemd-networkd[671]: veth99: Gained IPv6LL
Mar 22 10:29:02 Zeus systemd-networkd[671]: veth99: Link DOWN
Mar 22 10:29:02 Zeus systemd-networkd[671]: veth99: Lost carrier
Mar 22 10:29:13 Zeus systemd-networkd[671]: veth99: Link UP
Mar 22 10:29:13 Zeus systemd-networkd[671]: veth99: Gained carrier
Mar 22 10:29:14 Zeus systemd-networkd[671]: veth99: Gained IPv6LL

```

sd-network: Provice APIs to access SIP servers given by DHCP4 server

Silence Wstring-plus-int warning when using clangd with GCC.

network: DHCP lease load SIP copy paste error

sd-bus: whitespace adjustments

sd-bus: support SD_BUS_DEFAULT* and don't crash in functions where bus is optional

In those functions where bus defaults to the m->bus, we should also
resolve the magic parameters. And if neither called with bus=NULL
and an unattached message, return properly instead of crashing in assert
later.

sd-bus: make sure SD_BUS_DEFAULT* works everywhere

I'm not sure why those functions were not touched in
45b1f410ba699990e4033805fe64cc369b835f10. Anyway, it seems easier
to just support the magic parameters everywhere.

sd-bus: Add sd_bus_reply_method_return docs + cleanups

sd-bus: add sd_bus_message_seal docs + cleanups

Fix keys on Medion Akoya P6669

login: allow non-console sessions to change vt

When starting a wayland session through a systemd service for a non-root
user, the compositor (based on wlroots) is denied the authorization to
change vt.
Once the user logs in, either through a local console or via ssh, the
compositor can work properly.

This is related to the login polkit policy:
- `allow_inactive` has value `auth_admin_keep`, denying any non-root
  user session the authorization to change vt
- `allow_active` has value `yes`, which explains why the vt change
  becomes possible once the user logs in through another channel

By changing the `allow_inactive` value to `yes`, any user session setup
in a service file can switch vt, allowing wayland sessions for non-root
users.

logind: log a more accurate error when we failed at session creation

We used to log the following error:

  "Start job for unit user-1000.slice failed with 'canceled'"

which can be really misleading if the actual job failed at *stopping* a unit.

Indeed "Start" was hard coded but it was wrong since we can also fail with stop
jobs which are enqueued when a session is stopped.

Merge pull request #15153 from keszybz/man-bus-address

Add two man pages for sd-bus

network: Fix split in `SendOption=` on client and server

When specifying `DHCPv4.SendOption=`, it is used by systemd-networkd to
set the value of that option within the DHCP request that is sent out.
This differs to setting `DHCPServer.SendOption=`, which will place all
the options together as suboptions into the vendor-specific information
(code 43) option.

This commit adds two new config options, `DHCPv4.SendVendorOption=` and
`DHCPServer.SendVendorOption=`. These both have the behaviour of the old
`DHCPServer.SendOption=` flag, and set the value of the suboption in the
vendor-specific information option.

The behaviour of `DHCPServer.SendOption=` is then changed to reflect
that of `DHCPv4.SendOption=`. It will set the value of the corresponding
option in the DHCP request.

networkctl: Add support to display IPv6 addrgenmode

selinux: delay mac_selinux_enforcing call after SELinux was determined to be enabled

Calling `mac_selinux_enforcing()`, which calls `security_getenforce()`, on a SELinux disabled system causes the following error message to be printed:
    Failed to get SELinux enforced status: No such file or directory

Fixes: 257188f80ce1a083e3a88b679b898a73fecab53b ("selinux: cache enforced status and treat retrieve failure as enforced mode")
Supersedes: #15145

sd-bus: sd_bus_set/get_method_call_timeout docs + cleanups.

man: say "is" not "has been"

man: mention sd_bus_is_anonymous() and sd_bus_is_trusted()

sd-bus: mark sd_bus_try_close() as deprecated

codesearch.debian.net shows no uses (except for the definition in systemd and
elogind).

$ cat > test.c

int main() {
  sd_bus_try_close(NULL);
  return 0;
}
$ gcc -Isrc/systemd -Wall -o testbus test.c -lsystemd
test.c: In function ‘main’:
test.c:4:3: warning: ‘sd_bus_try_close’ is deprecated [-Wdeprecated-declarations]
    4 |   sd_bus_try_close(NULL);
      |   ^~~~~~~~~~~~~~~~
In file included from test.c:1:
src/systemd/sd-bus.h:180:5: note: declared here
  180 | int sd_bus_try_close(sd_bus *bus) _sd_deprecated_; /* deprecated */
      |     ^~~~~~~~~~~~~~~~

bus: drop dead code for kdbus support

sd_bus_try_close() always returns -EOPNOTSUPP if bus is a valid object.
It nevers returns -EBUSY. So we'd always go into the "fallback" path.

man: describe sd_bus_default_flush_close()

man: add sd_bus_set_address(3)

sd-bus: make bus_set_address_user always go through sd_bus_set_address

This way all the checks are done, and we don't leak a pointer if
bus_set_address_user() is called twice.

man: add sd_bus_start(3)

networkctl: Add support to display bond

Merge pull request #14749 from msekletar/cpu-aff-numa-v3

core: add support for setting CPUAffinity= to special "numa" value

sd-bus: sd_bus_call/sd_bus_call_async_docs + cleanups.

Merge pull request #15143 from ssahani/networkctl-tunnel-geneve

networkctl: Add support to display geneve tunnel info

networkctl: Add support to display vti and vti6 tunnels

networkctl: add support to display ip6gre, ip6gretap, ip6erspan

docs: Add syntax for templated units to systemd.preset man page

This documents the syntax

     enable template@.service foo bar baz

that was introduced in #9901 to preset templated units.

Merge pull request #15136 from yuwata/network-dhcp4-use-gateway

network: add a flag to ignore gateway provided by DHCP server

Merge pull request #15108 from keszybz/systemctl-set-default-notices

Make systemctl set-default hint about some common issues

networkctl: Add support to display gre gretap and erspan

networkctl: Add support to display geneve tunnel info

hwdb: add support for Lenovo Legion Y9000X2020 (#15127)

po: update Polish translation

Fix volume control keys on Lenovo Yoga S940

With the default config repeated press of fn+VolumeUp or fn+VolumeDown lead to
repeated presses even after release, which leads to volume going to 100% or 0%.

systemctl: print a notice when set-default is not effective

$ sudo ln -svf multi-user.target /run/systemd/generator.early/default.target
'/run/systemd/generator.early/default.target' -> 'multi-user.target'
$ sudo build/systemctl set-default --root=/ sysinit.target
Removed /etc/systemd/system/default.target.
Created symlink /etc/systemd/system/default.target → /usr/lib/systemd/system/sysinit.target.
Note: "multi-user.target" is the default unit (possibly a runtime override).

The output is not super informative, but it should be enough to point the user in
the right direction.

Fixes #3645.

networkctl: Add support to show tunnel (ipip/sit) local and remote address

sd-bus: Add sd_bus_method_call/sd_bus_method_call_async docs + cleanups.

Merge pull request #15138 from ssahani/networkctl-vlan

networkctl: Add support to display vlan ID

Merge pull request #15139 from DaanDeMeyer/sd-bus-remove-unused-cite

sd-bus: Remove unused man cite of `sd_bus_slot_new_signal`.

sd-bus: Remove unused man cite of `sd_bus_slot_new_signal`.

network: do not re-attach sd-event object

Fixes #15126.

network: can: add support for listen-only mode

Closes #15129.

networkctl: Add support to display master device

networkctl: Add support to display vlan ID

test-network: add a test case for DHCPv4.UseGateway=no

network: add a flag to ignore gateway provided by DHCP server

Closes #15117.

core: add support for setting CPUAffinity= to special "numa" value

systemd will automatically derive CPU affinity mask from NUMA node
mask.

Fixes #13248

shared: split out NUMA code from cpu-set-util.c to numa-util.c

home: fix segfault when parsing arguments in PAM module

NEWS: fix use of tabs instead of spaces for one item

sd-bus: Add sd_bus_set_fd documentation along with some cleanups.

test: wait a bit after starting the test service

otherwise we might end up being faster than the unit itself, causing
unexpected fails, like:

```
testsuite.sh[297]: + systemctl start issue_14566_test
testsuite.sh[297]: + systemctl status issue_14566_test
testsuite.sh[304]: ● issue_14566_test.service - Issue 14566 Repro
testsuite.sh[304]:      Loaded: loaded (/etc/systemd/system/issue_14566_test.service; static; vendor preset: enabled)
testsuite.sh[304]:      Active: active (running) since Sat 2020-03-14 02:02:23 UTC; 417ms ago
testsuite.sh[304]:    Main PID: 301 ((repro.sh))
testsuite.sh[304]:       Tasks: 1 (limit: 535)
testsuite.sh[304]:      Memory: 180.0K
testsuite.sh[304]:         CPU: 122ms
testsuite.sh[304]:      CGroup: /system.slice/issue_14566_test.service
testsuite.sh[304]:              └─301 [(repro.sh)]
testsuite.sh[307]: ++ cat /leakedtestpid
testsuite.sh[307]: cat: /leakedtestpid: No such file or directory
testsuite.sh[297]: + leaked_pid=
```

Merge pull request #15104 from ssahani/networkctl-qdisc

networkctl: Add support to display qdisc

systemctl: emit notice about some kernel commandline options

Things can be pretty confusing when there's a commandline option overrding the
configured default... Let's be nice to the user and emit a warning.

core: consistently emit oom warning when parsing args

In practice we are very unlikely to fail at this point, but for
consistency, we should always warn when allocation fails, and
we have free_and_strdup_warn() for this.

networkctl: Add support to display qdisc

./networkctl status ens38                                                                                                                                                                ─╯
● 4: ens38
             Link File: /usr/lib/systemd/network/99-default.link
          Network File: /usr/lib/systemd/network/10-ens38.network
                  Type: ether
                 State: routable (configured)
     Alternative Names: enp2s6
                  Path: pci-0000:02:06.0
                Driver: e1000
                Vendor: Intel Corporation
                 Model: 82545EM Gigabit Ethernet Controller (Copper) (PRO/1000 MT Single Port Adapter)
            HW Address: 00:0c:29:d2:42:7c (VMware, Inc.)
                   MTU: 1500 (min: 46, max: 16110)
                 QDisc: fq_codel        <============================
  Queue Length (Tx/Rx): 1/1
      Auto negotiation: yes
                 Speed: 1Gbps
                Duplex: full
                  Port: tp
               Address: 192.168.5.123
                        fe80::20c:29ff:fed2:427c

sd-netlink: Add IFLA_QDISC

fix journalctl regression (#15099)

This regression was introduced in #14913.

The current_file variable can be NULL, as, for example, with the
following commands:

* journalctl --list-boots
* journalctl -b -1 --no-pager

Since current_file is only checked for pointer equality with f, removing
the assertion is safe here.

Merge pull request #15097 from keszybz/job-logging-and-news-update

Job logging and news update

shared/ask-password-api: do not show hint on echo

Giving --echo to systemd-ask-password allows to echo the user input instead
of masking it. This is useful when querying for usernames or similar.

Showing "(press TAB for no echo)" does not make sense there, so do not.
Note that pressing TAB or ESC still disables echo.

fstab-generator: handle systemd.swap= command-line argument

Don't generate swap units if set to false

The inverse of this argument is present as "noswap" on Debian sysvinit

Ref:
https://salsa.debian.org/debian/sysvinit/blob/4422988cb41c3022eee7444378cac3b2e36eac28/debian/vars.sh#L34
https://salsa.debian.org/debian/sysvinit/blob/4422988cb41c3022eee7444378cac3b2e36eac28/debian/src/initscripts/etc/init.d/mountall.sh#L78

Fixes https://github.com/systemd/systemd/issues/6686