Merging upstream version 4.23.0.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 247 insertions, 7 deletions

diff --git a/upstream/fedora-rawhide/man5/systemd.link.5 b/upstream/fedora-rawhide/man5/systemd.link.5
index 359f1911..63d7e08e 100644
--- a/upstream/fedora-rawhide/man5/systemd.link.5
+++ b/upstream/fedora-rawhide/man5/systemd.link.5
@@ -1,5 +1,5 @@
 '\" t
-.TH "SYSTEMD\&.LINK" "5" "" "systemd 255" "systemd.link"
+.TH "SYSTEMD\&.LINK" "5" "" "systemd 256~rc3" "systemd.link"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -345,6 +345,97 @@ A description of the device\&.
 Added in version 211\&.
 .RE
 .PP
+\fIProperty=\fR
+.RS 4
+Set specified udev properties\&. This takes space separated list of key\-value pairs concatenated with equal sign ("=")\&. Example:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+Property=HOGE=foo BAR=baz
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+This option supports simple specifier expansion, see the Specifiers section below\&. This option can be specified multiple times\&. If an empty string is assigned, then the all previous assignments are cleared\&.
+.sp
+This setting is useful to configure the
+"ID_NET_MANAGED_BY="
+property which declares which network management service shall manage the interface, which is respected by systemd\-networkd and others\&. Use
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+Property=ID_NET_MANAGED_BY=io\&.systemd\&.Network
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+to declare explicitly that
+\fBsystemd\-networkd\fR
+shall manage the interface, or set the property to something else to declare explicitly it shall not do so\&. See
+\fBsystemd.network\fR(5)
+for details how this property is used to match interface names\&.
+.sp
+Added in version 256\&.
+.RE
+.PP
+\fIImportProperty=\fR
+.RS 4
+Import specified udev properties from the saved database\&. This takes space separated list of property names\&. Example:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ImportProperty=HOGE BAR
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+This option supports simple specifier expansion, see the Specifiers section below\&. This option can be specified multiple times\&. If an empty string is assigned, then the all previous assignments are cleared\&.
+.sp
+If the same property is also set in
+\fIProperty=\fR
+in the above, then the imported property value will be overridden by the value specified in
+\fIProperty=\fR\&.
+.sp
+Added in version 256\&.
+.RE
+.PP
+\fIUnsetProperty=\fR
+.RS 4
+Unset specified udev properties\&. This takes space separated list of property names\&. Example:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+ImportProperty=HOGE BAR
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+This option supports simple specifier expansion, see the Specifiers section below\&. This option can be specified multiple times\&. If an empty string is assigned, then the all previous assignments are cleared\&.
+.sp
+This setting is applied after
+\fIImportProperty=\fR
+and
+\fIProperty=\fR
+are applied\&. Hence, if the same property is specified in
+\fIImportProperty=\fR
+or
+\fIProperty=\fR, then the imported or specified property value will be ignored, and the property will be unset\&.
+.sp
+Added in version 256\&.
+.RE
+.PP
 \fIAlias=\fR
 .RS 4
 The
@@ -493,7 +584,7 @@ and
 "%"\&. While
 "\&."
 is an allowed character, it\*(Aqs recommended to avoid it when naming interfaces as various tools (such as
-\fBresolvconf\fR(1)) use it as separator character\&. Also, fully numeric interface names are not allowed (in order to avoid ambiguity with interface specification by numeric indexes), as are the special strings
+\fBresolvconf\fR(1)) use it as separator character\&. Also, fully numeric interface names are not allowed (in order to avoid ambiguity with interface specification by numeric indexes), nor are the special strings
 "\&.",
 "\&.\&.",
 "all"
@@ -1584,6 +1675,17 @@ Takes a boolean\&. If set to true, Large Receive Offload (LRO) is enabled\&. Whe
 Added in version 232\&.
 .RE
 .PP
+\fIReceivePacketSteeringCPUMask=\fR
+.RS 4
+Configures Receive Packet Steering (RPS) list of CPUs to which RPS may forward traffic\&. Takes a list of CPU indices or ranges separated by either whitespace or commas\&. Alternatively, takes the special value
+"all"
+in which will include all available CPUs in the mask\&. CPU ranges are specified by the lower and upper CPU indices separated by a dash (e\&.g\&.
+"2\-6")\&. This option may be specified more than once, in which case the specified CPU affinity masks are merged\&. If an empty string is assigned, the mask is reset, all assignments prior to this will have no effect\&. Defaults to unset and RPS CPU list is unchanged\&. To disable RPS when it was previously enabled, use the special value
+"disable"\&.
+.sp
+Added in version 256\&.
+.RE
+.PP
 \fIReceiveVLANCTAGHardwareAcceleration=\fR
 .RS 4
 Takes a boolean\&. If set to true, receive VLAN CTAG hardware acceleration is enabled\&. When unset, the kernel\*(Aqs default will be used\&.
@@ -1828,6 +1930,148 @@ Specifies the MAC address for the virtual function\&.
 .sp
 Added in version 251\&.
 .RE
+.SH "SPECIFIERS"
+.PP
+Some settings resolve specifiers which may be used to write generic unit files referring to runtime or unit parameters that are replaced when the unit files are loaded\&. Specifiers must be known and resolvable for the setting to be valid\&. The following specifiers are understood:
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.B Table\ \&2.\ \&Specifiers available in unit files
+.TS
+allbox tab(:);
+lB lB lB.
+T{
+Specifier
+T}:T{
+Meaning
+T}:T{
+Details
+T}
+.T&
+l l l
+l l l
+l l l
+l l l
+l l l
+l l l
+l l l
+l l l
+l l l
+l l l
+l l l
+l l l
+l l l
+l l l
+l l l.
+T{
+"%a"
+T}:T{
+Architecture
+T}:T{
+A short string identifying the architecture of the local system\&. A string such as \fBx86\fR, \fBx86\-64\fR or \fBarm64\fR\&. See the architectures defined for \fIConditionArchitecture=\fR in \fBsystemd.unit\fR(5) for a full list\&.
+T}
+T{
+"%A"
+T}:T{
+Operating system image version
+T}:T{
+The operating system image version identifier of the running system, as read from the \fIIMAGE_VERSION=\fR field of /etc/os\-release\&. If not set, resolves to an empty string\&. See \fBos-release\fR(5) for more information\&.
+T}
+T{
+"%b"
+T}:T{
+Boot ID
+T}:T{
+The boot ID of the running system, formatted as string\&. See \fBrandom\fR(4) for more information\&.
+T}
+T{
+"%B"
+T}:T{
+Operating system build ID
+T}:T{
+The operating system build identifier of the running system, as read from the \fIBUILD_ID=\fR field of /etc/os\-release\&. If not set, resolves to an empty string\&. See \fBos-release\fR(5) for more information\&.
+T}
+T{
+"%H"
+T}:T{
+Host name
+T}:T{
+The hostname of the running system\&.
+T}
+T{
+"%l"
+T}:T{
+Short host name
+T}:T{
+The hostname of the running system, truncated at the first dot to remove any domain component\&.
+T}
+T{
+"%m"
+T}:T{
+Machine ID
+T}:T{
+The machine ID of the running system, formatted as string\&. See \fBmachine-id\fR(5) for more information\&.
+T}
+T{
+"%M"
+T}:T{
+Operating system image identifier
+T}:T{
+The operating system image identifier of the running system, as read from the \fIIMAGE_ID=\fR field of /etc/os\-release\&. If not set, resolves to an empty string\&. See \fBos-release\fR(5) for more information\&.
+T}
+T{
+"%o"
+T}:T{
+Operating system ID
+T}:T{
+The operating system identifier of the running system, as read from the \fIID=\fR field of /etc/os\-release\&. See \fBos-release\fR(5) for more information\&.
+T}
+T{
+"%q"
+T}:T{
+Pretty host name
+T}:T{
+The pretty hostname of the running system, as read from the \fIPRETTY_HOSTNAME=\fR field of /etc/machine\-info\&. If not set, resolves to the short hostname\&. See \fBmachine-info\fR(5) for more information\&.
+T}
+T{
+"%T"
+T}:T{
+Directory for temporary files
+T}:T{
+This is either /tmp or the path "$TMPDIR", "$TEMP" or "$TMP" are set to\&. (Note that the directory may be specified without a trailing slash\&.)
+T}
+T{
+"%v"
+T}:T{
+Kernel release
+T}:T{
+Identical to \fBuname \-r\fR output\&.
+T}
+T{
+"%V"
+T}:T{
+Directory for larger and persistent temporary files
+T}:T{
+This is either /var/tmp or the path "$TMPDIR", "$TEMP" or "$TMP" are set to\&. (Note that the directory may be specified without a trailing slash\&.)
+T}
+T{
+"%w"
+T}:T{
+Operating system version ID
+T}:T{
+The operating system version identifier of the running system, as read from the \fIVERSION_ID=\fR field of /etc/os\-release\&. If not set, resolves to an empty string\&. See \fBos-release\fR(5) for more information\&.
+T}
+T{
+"%W"
+T}:T{
+Operating system variant ID
+T}:T{
+The operating system variant identifier of the running system, as read from the \fIVARIANT_ID=\fR field of /etc/os\-release\&. If not set, resolves to an empty string\&. See \fBos-release\fR(5) for more information\&.
+T}
+.TE
+.sp 1
 .SH "EXAMPLES"
 .PP
 \fBExample\ \&1.\ \&/usr/lib/systemd/network/99\-default\&.link\fR
@@ -2032,11 +2276,7 @@ MACAddress=cb:a9:87:65:43:21
 .\}
 .SH "SEE ALSO"
 .PP
-\fBsystemd-udevd.service\fR(8),
-\fBudevadm\fR(8),
-\fBsystemd.netdev\fR(5),
-\fBsystemd.network\fR(5),
-\fBsystemd-network-generator.service\fR(8)
+\fBsystemd-udevd.service\fR(8), \fBudevadm\fR(8), \fBsystemd.netdev\fR(5), \fBsystemd.network\fR(5), \fBsystemd-network-generator.service\fR(8)
 .SH "NOTES"
 .IP " 1." 4
 System and Service Credentials