diff --git a/man/networkctl.xml b/man/networkctl.xml
index 8e668ade91..7877755edf 100644
--- a/man/networkctl.xml
+++ b/man/networkctl.xml
@@ -92,6 +92,88 @@
4 virbr0-nic ether off unmanaged
4 links listed.
+
+ The operational status is one of the following:
+
+
+ off
+
+ the device is powered down
+
+
+
+ no-carrier
+
+ the device is powered up, but it does not yet have a carrier
+
+
+
+ dormant
+
+ the device has a carrier, but is not yet ready for normal traffic
+
+
+
+ carrier
+
+ the link has a carrier
+
+
+
+ degraded
+
+ the link has carrier and addresses valid on the local link configured
+
+
+
+ routable
+
+ the link has carrier and routable address configured
+
+
+
+
+
+ The setup status is one of the following:
+
+
+ pending
+
+ udev is still processing the link, we don't yet know if we will manage it
+
+
+
+ failed
+
+ networkd failed to manage the link
+
+
+
+ configuring
+
+ in the process of retrieving configuration or configuring the link
+
+
+
+ configured
+
+ link configured successfully
+
+
+
+ unmanaged
+
+ networkd is not handling the link
+
+
+
+ linger
+
+ the link is gone, but has not yet been dropped by networkd
+
+
+
+