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.

Merge pull request #14525 from yuwata/mount-use-format-table

systemd-mount: use format-table.[ch]

bash-completion: networkctl: support --full and --lines

core: be more restrictive on the dependency types we allow to be created transiently

We should allow the ones that the [Unit] section of regular unit files
may accet, but no other, in particular not the internal deps we
synthesize as reverse of explicitly configured ones, such was WantedBy=.

Fixes: #14251

timedatectl: use format-table.[ch]

systemd-mount: add --no-legend command line option

systemd-mount: use format-table.[ch]

format-table: introduce TABLE_PATH

udev: don't import parent ID_FS_ data on partitions

When probing partitions, we inherit important information from the parent
disk device such as ID_MODEL, and usage of such properties is seen to
be acceptable and well established.

However, we need to exclude filesystem information from the properties
that get inherited. Information about the device content should not be
passed on in this way.

For example, Linux distro install media commonly uses an ISO filesystem
plus a partition table. The ISO filesystem is detected on the main disk
device, but we should not pass down those details to the partitions,
some or all of which may be pointing at storage areas completely distinct
from the ISO filesystem.

This is particularly problematic when adding new partitions on media
set up in this way (since the new partitions are then reported to contain
the parent device's ISO filesystem), or when dealing with more unusual
hybrid ISO layouts. The inaccuracy of information here inversely affects
users of blkid and udev's persistent storage symlinks.

Exclude ID_FS_* properties from the inheritance chain to avoid these
problems.

Fixes: #14408

Merge pull request #14523 from keszybz/refactorings

Refactorings inspired by recent pull requests

sd-event: use _cleanup_ in one more place

sd-event: use RAII for struct epoll_event

Inspired by #14353.

network: use automatic stack allocation and structured init

network: do not require ethtool_get_permanent_macaddr() to get an fd

test: minor typo fix

As pointed out on: https://github.com/systemd/systemd/pull/14465#discussion_r364152064

Merge pull request #14448 from yuwata/network-permanent-mac-address

network, udev: support permanent mac address

Merge pull request #14518 from keszybz/interface-text

doc: tweak grammar in CONTAINER_INTERFACE description

Merge pull request #14511 from keszybz/sleep-check-rework

Sleep check rework

Merge pull request #14512 from poettering/root-image-devices

Make RootImage= work reliable with DeviceAllow= in the mix

test: pin meson to 0.52.1 for fuzzit/fuzzbuzz

Latest meson doesn't work with older python 3.5, which is present on
Ubuntu 16.04. Let's pin in to the latest working version (0.52.1) until
we properly bump all necessary Ubuntu images to 18.04.

See: https://github.com/mesonbuild/meson/issues/6427

network: rename *fd to *ethtool_fd

man: use xi:include to avoid duplication

... and fix some unwarranted discrepancies between the two man pages.

Merge pull request #14465 from poettering/setprio-rework

When Nice= is used, clamp to RLIMIT_NICE

Merge pull request #14488 from yuwata/networkctl-show-logs

networkctl: status command also shows logs of networkd

man: fix option name

doc: tweak grammar in CONTAINER_INTERFACE description

The only non-stylistic change is to replace descriptions of how we are
encouraging people to use PrivateTmp= and such, because now they are widely
used.

Merge pull request #14494 from poettering/container-interface

Let's import the container interface description text from the fdo wiki

networkctl: show permanent mac address if it is not used now

network, udev: introduce PermanentMACAddress= setting in [Match] section

Closes #13983.

Support Plugable UD-PRO8 dock

Add support for Plugable Pro8 docking station for auto-configuring seat

ethtool: introduce ethtool_get_permanent_macaddr()

Will be used in later commits.

gpt-auto: don't assume XBOOTLDR is vfat

Let's not assume "umask=" is a valid mount option for XBOOTLDR
partitions unconditionally.

Fixes: #14165

network, meson: allow statically linked build

Build option "link-networkd-shared" to build a statically linked
systemd-networkd by using

  -Dlink-udev-shared=false -Dlink-networkd-shared=false

on systems with full systemd stack except systemd-networkd, such
as RHEL/CentOS 8.

Merge pull request #14510 from poettering/net-naming-scheme-fixlets

some net naming scheme documentation fixes

zsh: Complete systemctl subcommands in separate tags

Fixes #14422

shared/sleep-config: do not ignore resume_offset when resume not set

This is most likely a user error, let's make it easier to diagnose.

shared/sleep-config: make swap detection stricter again

To make this easier to understand, let's always log (at debug level)
when we accept or reject each device:
/swapfile: detection of swap file offset on Btrfs is not supported
/swapfile: is a candidate device.
/dev/zram0: ignoring zram swap
/dev/vdb: ignoring device with lower priority
/dev/vdc: ignoring device with lower usable space
...

If we know that hibernation will fail, refuse. This includes cases where
/sys/power/resume is set and doesn't match any device, or
/sys/power/resume_offset is set and we're not on btrfs and it doesn't match.
If /sys/power/resume is not set at all, we still accept the device with the
highest priority (see 6d176522f5480ea9e9a83de5ef5ea5e0d95b79cb and
88bc86fcf895da0d51ddaf93d17b4280f4e60d74)

Tested cases:
1. no swap active → refuse
2. just zram swap active → refuse
3. swapfile on btrfs with /sys/power/resume{,_offset} set → OK
4. swapfile on btrfs with /sys/power/resume set, offset not set → refuse
5. swapfile on btrfs with /sys/power/resume set to nonexistent device, offset set → refuse
6. /sys/power/resume not set, offset set, candidate exists → OK (*)
7. /sys/power/resume not set, offset not set, candidate exists → OK

(*) I think this should fail, but I'm leaving that for the next commit.

Merge pull request #14423 from danielshahaf/zsh-add-missing-completions

zsh: Add missing completions

boot: fix osrel parser

let's check VERSION instead of VERSION_ID where appropriate.

Fixes: #14493

Merge pull request #14472 from poettering/test-43-fixes

Various robustness fixes for TEST-43-PRIVATEUSER-UNPRIV

Merge pull request #14499 from yuwata/network-gateway-dhcp

network: static route via DHCP gateway

man: stop recommending modprobe -abq in ExecStartPre=

units: tweaks to modprobe@.service

Let's use uppercase wording in the description string, like we usually
do.

Let's allow using this service in early boot.

If it's pulled into the initial transaction it's better to finish
loading this before sysinit.target.

Don't bother with this in containers that lack CAP_SYS_MODULE

unit: make sure to pull in modprobe@loop.service when RootImage= is used with DeviceAllow=

Fixes: #14214

bpf-devices: line-break some overly long function signatures

units: Split modprobing out into a separate service unit

Devices referred to by `DeviceAllow=` sandboxing are resolved into their
corresponding major numbers when the unit is loaded by looking at
`/proc/devices`. If a reference is made to a device which is not yet
available, the `DeviceAllow` is ignored and the unit's processes cannot
access that device.

In both logind and nspawn, we have `DeviceAllow=` lines, and `modprobe`
in `ExecStartPre=` to load some kernel modules. Those kernel modules
cause device nodes to become available when they are loaded: the device
nodes may not exist when the unit itself is loaded. This means that the
unit's processes will not be able to access the device since the
`DeviceAllow=` will have been resolved earlier and denied it.

One way to fix this would be to re-evaluate the available devices and
re-apply the policy to the cgroup, but this cannot work atomically on
cgroupsv1. So we fall back to a second approach: instead of running
`modprobe` via `ExecStartPre`, we move this out to a separate unit and
order it before the units which want the module.

Closes #14322.
Fixes: #13943.

udev: use dot_or_dot_dot() where appropriate

man: fix documentation of IBM VIO device naming

We generate "v" in two different ways, and they got mixed up.

man: slightly extend documentation on difference between ID_NET_NAME_ONBOARD and ID_NET_LABEL_ONBOARD

shared/sleep: use stat() instead of open()+fstat() in one place

No functional change.

udev: do not use exact match of file permission

This partially reverts 25de7aa7b90c23d33ea50ada1e50c5834a414237.

Fixes #14473.

Merge pull request #14481 from yuwata/virt-string-table

virt: use string table to detect VM or container

nspawn: set original ifname as alternative if it is truncated

network: append INTERFACE= attributes for logs corresponds to a netif

test-network: suppress logs in status command

networkctl: status command also shows logs of networkd

Closes #14050.

man: drop unnecessary white space

locale-util: extend comments on unicode glyph use, and drop mdash (that actually was an ndash)

Let's add the actual unicode names of the glyphs we use. Let's also add
in comments what the width expectations of these glyphs are on the
console.

Also, remove the "mdash" definition. First of all it wasn't used, but
what's worse the glyph encoded was actually an "ndash"...

Fixes: #14075

Merge pull request #14420 from DaanDeMeyer/nspawn-fix-read-only-overlay-rootfs

nspawn: Don't mount read-only if we have a custom mount on root.

test-network: add test for Gateway=DHCP

network: static routes via DHCP gateway

This makes Gateway= also take "DHCP". If "DHCP" is set, then the gateway
address provided by DHCP or IPv6 RA is used.

Closes #8213.

virt: drop trailing white spaces

virt: use string table to detect VM or container

pkcs11-util: don't mask return value of the first asprintf()

Fixes CID#1409666

network: lower the log-level of harmless message

Closes #14285.

meson: drop unnecessary linking of libudev_core

sd-netlink: fix copy and paste mistake

man: change links to container interface doc to https://systemd.io/

Now that we converted the documentation we should also link to it.

docs: move container interface docs from wiki to markdown

Let's move
https://www.freedesktop.org/wiki/Software/systemd/ContainerInterface/
into our tree and convert it to Markdown.

This also incldues some minor fixes and other changes.

sd-netlink: use uint8_t* for non-character data

testsuite: drop "systemctl is-system-running --wait" invocation

We wait for "basic.target" being reached in the user instance anyway
before allowing the user's session to start, hence doing such a wait is
unnecessary, since that would just mean we'd wait for "default.target"
on top of "basic.target", but we shouldn#t need anything of that...

Hence, let's simplify this, reduce explicit sync points.

test: don't rely on "nobody" user for TEST-43

The name is not as universal as we want, still, hence let's use our own
user we create with sysusers.d/. That should yield same behaviour
everywhere (and also test sysusers a bit as side effect).

test: hardcode shell to use

let's make sure we always invoke our commands through /bin/sh, since
on some distros su will use /bin/nologin (or whatever is listed in
/etc/passwd) as shell otherwise and we don#t want that.

systemd-sleep: always attempt hibernation if configured

When calculation of swap file offset is unsupported, rely on the
/sys/power/resume & /sys/power/resume_offset values if configured
rather than requiring a matching swap entry to be identified.

Refactor to use dev_t for comparison of resume= device instead of string.

dbus-execute: avoid extra strdup()

bind_mount_add does the strdup(), so we can avoid
strdup()ing the strings.

test: use symlinks for Makefiles

for some reason the newer tests used file copyies instead of symlinks.
let's fix that.

job: Don't mark as redundant if deps are relevant

In the steps given in #13850, the resulting graph looks like:

    C (Anchor) -> B -> A

Since B is inactive, it will be flagged as redundant and removed from
the transaction, causing A to get garbage collected. The proposed fix is
to not mark nodes as redundant if doing so causes a relevant node to be
garbage collected.

Fixes #13850

Merge pull request #14194 from yuwata/network-multipath-routing-12541

network: introduce multipath routing

Merge pull request #14469 from aburch/man-tmpfiles.d-minor-improvements

man: tmpfiles.d: minor improvements

nspawn: Make a custom mount on root imply --read-only.

nspawn: Don't mount read-only if we have a custom mount on root.

Merge pull request #14401 from DaanDeMeyer/nspawn-move-veth-back-to-host

nspawn: move virtual interfaces added with --network-interface back to the host

man: tmpfiles.d: only list "v" once

man: tmpfiles.d: "b", "c" options require major and minor numbers

hwdb: Lenovo T490 Synaptics Touchpad hwdb entry

The Synaptics Touchpad that comes with the T490 doesn't explicitly set
its resolution, so these lines are needed to provide that, in order to
help the libinput code detect overly large jumps.  Since this device
contains buttons under the lower section of the touchpad, large jumps
are common, so having the resolution helps libinput greatly reduce
the number of occurances of pointer jump.

This comes from
https://gitlab.freedesktop.org/libinput/libinput/issues/402.

Merge pull request #14467 from poettering/nspawn-short-names-rework

nspawn: change how we truncate --network-veth names

test: add test case for setpriority_closest()

core: in execute, Never fail setting Nice priority

Instead, push to the closest possible Nice priority setting.

Replaces: #11397

nspawn: Generate unique short veth names

This commit lowers the chance of having veth name conflicts for machines
created with similar names.

Replaces: #12865
Fixes: #13417

udev: move naming-scheme.[ch] into src/shared/

That way we can use it from non-udev code too, for example nspawn.

Merge pull request #13748 from jwrdegoede/hwdb-updates2

Add LCD menu key mappings for the Logitech MX5000 and MX5500

systemctl: show 'VENDOR PRESET' column in 'list-unit-files'

Show the install value presets would suggest for each service in a
separate column.

systemctl: skip non-existent units in the 'cat' verb

When processing list of units (either provided manually or as a
wildcard), let's skip units for which we don't have an on-disk
counterpart, but note the -ENOENT error code and propagate it back to
the user.

Fixes: #14082

Merge pull request #14444 from yuwata/network-codel-more

network: more CoDel settings

systemd.exec: document the file system for EnvironmentFile paths

Files specified with EnvironmentFile are read from PID1 mount namespace, before
any file system operations like RootImage or BindPaths are in effect.

nspawn: Move --network-interface interfaces back to the host.

Merge pull request #14441 from GothAck/gothack_type.d_dropin_test_master

Fix type.d drop-in ordering for #14439 - duplicate against master

hwdb: 60-sensor.hwdb Chuwi Hi10 CWI515 accelerometer orientation.

Update Galician translations

systemd-analyze: fixed typo in documentation

The example shows the output of critical-chain, which means
that the title is wrong.