Merging upstream version 4.23.0.

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

1 files changed, 107 insertions, 26 deletions

diff --git a/upstream/opensuse-tumbleweed/man1/networkctl.1 b/upstream/opensuse-tumbleweed/man1/networkctl.1
index ae64e56a..7bdbc0e0 100644
--- a/upstream/opensuse-tumbleweed/man1/networkctl.1
+++ b/upstream/opensuse-tumbleweed/man1/networkctl.1
@@ -1,5 +1,5 @@
 '\" t
-.TH "NETWORKCTL" "1" "" "systemd 254" "networkctl"
+.TH "NETWORKCTL" "1" "" "systemd 255" "networkctl"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -60,86 +60,124 @@ The operational status is one of the following:
 .PP
 missing
 .RS 4
-the device is missing
+The device is missing\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 off
 .RS 4
-the device is powered down
+The device is powered down\&.
+.sp
+Added in version 240\&.
 .RE
 .PP
 no\-carrier
 .RS 4
-the device is powered up, but it does not yet have a carrier
+The device is powered up, but does not yet have a carrier\&.
+.sp
+Added in version 240\&.
 .RE
 .PP
 dormant
 .RS 4
-the device has a carrier, but is not yet ready for normal traffic
+The device has a carrier, but is not yet ready for normal traffic\&.
+.sp
+Added in version 240\&.
 .RE
 .PP
 degraded\-carrier
 .RS 4
-one of the bonding or bridge slave network interfaces is in off, no\-carrier, or dormant state, and the master interface has no address\&.
+One of the bonding or bridge slave network interfaces is in off, no\-carrier, or dormant state, and the master interface has no address\&.
+.sp
+Added in version 242\&.
 .RE
 .PP
 carrier
 .RS 4
-the link has a carrier, or for bond or bridge master, all bonding or bridge slave network interfaces are enslaved to the master
+The link has carrier, or for bond or bridge master, all bonding or bridge slave network interfaces are enslaved to the master\&.
+.sp
+Added in version 240\&.
 .RE
 .PP
 degraded
 .RS 4
-the link has carrier and addresses valid on the local link configured\&. For bond or bridge master this means that not all slave network interfaces have carrier but at least one does\&.
+The link has carrier and addresses valid on the local link configured\&. For bond or bridge master this means that not all slave network interfaces have carrier but at least one does\&.
+.sp
+Added in version 240\&.
 .RE
 .PP
 enslaved
 .RS 4
-the link has carrier and is enslaved to bond or bridge master network interface
+The link has carrier and is enslaved to bond or bridge master network interface\&.
+.sp
+Added in version 242\&.
 .RE
 .PP
 routable
 .RS 4
-the link has carrier and routable address configured\&. For bond or bridge master it is not necessary for all slave network interfaces to have carrier, but at least one must\&.
+The link has carrier and routable address configured\&. For bond or bridge master it is not necessary for all slave network interfaces to have carrier, but at least one must\&.
+.sp
+Added in version 240\&.
 .RE
 .sp
 The setup status is one of the following:
 .PP
 pending
 .RS 4
-udev is still processing the link, we don\*(Aqt yet know if we will manage it
+\fBsystemd-udevd\fR(8)
+is still processing the link, we don\*(Aqt yet know if we will manage it\&.
+.sp
+Added in version 240\&.
 .RE
 .PP
 initialized
 .RS 4
-udev has processed the link, but we don\*(Aqt yet know if we will manage it
+\fBsystemd-udevd\fR(8)
+has processed the link, but we don\*(Aqt yet know if we will manage it\&.
+.sp
+Added in version 251\&.
 .RE
 .PP
 configuring
 .RS 4
-in the process of retrieving configuration or configuring the link
+Configuration for the link is being retrieved or the link is being configured\&.
+.sp
+Added in version 240\&.
 .RE
 .PP
 configured
 .RS 4
-link configured successfully
+Link has been configured successfully\&.
+.sp
+Added in version 240\&.
 .RE
 .PP
 unmanaged
 .RS 4
-networkd is not handling the link
+\fBsystemd\-networkd\fR
+is not handling the link\&.
+.sp
+Added in version 240\&.
 .RE
 .PP
 failed
 .RS 4
-networkd failed to manage the link
+\fBsystemd\-networkd\fR
+failed to configure the link\&.
+.sp
+Added in version 240\&.
 .RE
 .PP
 linger
 .RS 4
-the link is gone, but has not yet been dropped by networkd
+The link is gone, but has not yet been dropped by
+\fBsystemd\-networkd\fR\&.
+.sp
+Added in version 240\&.
 .RE
 .sp
+Added in version 219\&.
 .RE
 .PP
 \fBstatus\fR [\fIPATTERN\&...\fR]
@@ -174,24 +212,33 @@ In the overall network status, the online state depends on the individual online
 .PP
 unknown
 .RS 4
-all links have unknown online status (i\&.e\&. there are no required links)
+All links have unknown online status (i\&.e\&. there are no required links)\&.
+.sp
+Added in version 249\&.
 .RE
 .PP
 offline
 .RS 4
-all required links are offline
+All required links are offline\&.
+.sp
+Added in version 249\&.
 .RE
 .PP
 partial
 .RS 4
-some, but not all, required links are online
+Some, but not all, required links are online\&.
+.sp
+Added in version 249\&.
 .RE
 .PP
 online
 .RS 4
-all required links are online
+All required links are online\&.
+.sp
+Added in version 249\&.
 .RE
 .sp
+Added in version 219\&.
 .RE
 .PP
 \fBlldp\fR [\fIPATTERN\&...\fR]
@@ -222,6 +269,8 @@ s \- Service VLAN, m \- Two\-port MAC Relay (TPMR)
 .if n \{\
 .RE
 .\}
+.sp
+Added in version 219\&.
 .RE
 .PP
 \fBlabel\fR
@@ -253,31 +302,43 @@ Prefix/Prefixlen                          Label
 .if n \{\
 .RE
 .\}
+.sp
+Added in version 234\&.
 .RE
 .PP
 \fBdelete\fR \fIDEVICE\&...\fR
 .RS 4
 Deletes virtual netdevs\&. Takes interface name or index number\&.
+.sp
+Added in version 243\&.
 .RE
 .PP
 \fBup\fR \fIDEVICE\&...\fR
 .RS 4
 Bring devices up\&. Takes interface name or index number\&.
+.sp
+Added in version 246\&.
 .RE
 .PP
 \fBdown\fR \fIDEVICE\&...\fR
 .RS 4
 Bring devices down\&. Takes interface name or index number\&.
+.sp
+Added in version 246\&.
 .RE
 .PP
 \fBrenew\fR \fIDEVICE\&...\fR
 .RS 4
 Renew dynamic configurations e\&.g\&. addresses received from DHCP server\&. Takes interface name or index number\&.
+.sp
+Added in version 244\&.
 .RE
 .PP
 \fBforcerenew\fR \fIDEVICE\&...\fR
 .RS 4
 Send a FORCERENEW message to all connected clients, triggering DHCP reconfiguration\&. Takes interface name or index number\&.
+.sp
+Added in version 246\&.
 .RE
 .PP
 \fBreconfigure\fR \fIDEVICE\&...\fR
@@ -289,6 +350,8 @@ or
 corresponding to the specified interface\&. So, if you edit config files, it is necessary to call
 \fBnetworkctl reload\fR
 first to apply new settings\&.
+.sp
+Added in version 244\&.
 .RE
 .PP
 \fBreload\fR
@@ -306,6 +369,8 @@ is modified or removed,
 does not update or remove the netdev\&. If a new, modified or removed
 \&.network
 file is found, then all interfaces which match the file are reconfigured\&.
+.sp
+Added in version 244\&.
 .RE
 .PP
 \fBedit\fR \fIFILE\fR|\fI@DEVICE\fR\&...
@@ -334,9 +399,11 @@ or
 files finishes\&. The same applies for
 \&.link
 files and
-\fBsystemd\-udevd\fR\&. Note that the changed link settings are not automatically applied after reloading\&. To achieve that, trigger uevents for the corresponding interface\&. Refer to
+\fBsystemd-udevd\fR(8)\&. Note that the changed link settings are not automatically applied after reloading\&. To achieve that, trigger uevents for the corresponding interface\&. Refer to
 \fBsystemd.link\fR(5)
 for more information\&.
+.sp
+Added in version 254\&.
 .RE
 .PP
 \fBcat\fR \fIFILE\fR|\fI@DEVICE\fR\&...
@@ -345,6 +412,8 @@ Show network configuration files\&. This command honors the
 "@"
 prefix in the same way as
 \fBedit\fR\&.
+.sp
+Added in version 254\&.
 .RE
 .SH "OPTIONS"
 .PP
@@ -354,41 +423,53 @@ The following options are understood:
 .RS 4
 Show all links with
 \fBstatus\fR\&.
+.sp
+Added in version 219\&.
 .RE
 .PP
 \fB\-s\fR \fB\-\-stats\fR
 .RS 4
 Show link statistics with
 \fBstatus\fR\&.
+.sp
+Added in version 243\&.
 .RE
 .PP
 \fB\-l\fR, \fB\-\-full\fR
 .RS 4
 Do not ellipsize the output\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
 \fB\-n\fR, \fB\-\-lines=\fR
 .RS 4
 When used with
 \fBstatus\fR, controls the number of journal lines to show, counting from the most recent ones\&. Takes a positive integer argument\&. Defaults to 10\&.
+.sp
+Added in version 245\&.
 .RE
 .PP
-\fB\-\-drop\-in=\fR
+\fB\-\-drop\-in=\fR\fINAME\fR
 .RS 4
-\fINAME\fRWhen used with
+When used with
 \fBedit\fR, edit the drop\-in file
 \fINAME\fR
 instead of the main configuration file\&.
+.sp
+Added in version 254\&.
 .RE
 .PP
 \fB\-\-no\-reload\fR
 .RS 4
 When used with
 \fBedit\fR,
-\fBsystemd\-networkd\fR
+\fBsystemd-networkd.service\fR(8)
 or
-\fBsystemd\-udevd\fR
+\fBsystemd-udevd.service\fR(8)
 will not be reloaded after the editing finishes\&.
+.sp
+Added in version 254\&.
 .RE
 .PP
 \fB\-\-json=\fR\fIMODE\fR