From 1d5db7b9f36fd903906783ccb300d5c02f89836e Mon Sep 17 00:00:00 2001
From: Yu Watanabe <watanabe.yu+github@gmail.com>
Date: Wed, 6 Sep 2023 04:32:04 +0900
Subject: [PATCH] man: mention DBus interfaces for DHCP clients

Follow-up for #28896.
---
 man/org.freedesktop.network1.xml | 74 ++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)

diff --git a/man/org.freedesktop.network1.xml b/man/org.freedesktop.network1.xml
index 6c462adbcbc..f022463310e 100644
--- a/man/org.freedesktop.network1.xml
+++ b/man/org.freedesktop.network1.xml
@@ -474,6 +474,80 @@ node /org/freedesktop/network1/link/_1 {
     </para>
   </refsect1>
 
+  <refsect1>
+    <title>DHCPv4 Client Object</title>
+
+    <programlisting executable="systemd-networkd" node="/org/freedesktop/network1/link/_1" interface="org.freedesktop.network1.DHCPv4Client">
+node /org/freedesktop/network1/link/_1 {
+  interface org.freedesktop.network1.DHCPv4Client {
+    properties:
+      readonly s State = '...';
+  };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
+  interface org.freedesktop.network1.Link { ... };
+};
+    </programlisting>
+
+    <!--property State is not documented!-->
+
+    <!--Autogenerated cross-references for systemd.directives, do not edit-->
+
+    <variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.Link"/>
+
+    <variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.DHCPv4Client"/>
+
+    <variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.Link"/>
+
+    <variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.DHCPv4Client"/>
+
+    <variablelist class="dbus-property" generated="True" extra-ref="State"/>
+
+    <!--End of Autogenerated section-->
+
+    <para>
+      Provides information about DHCPv4 client status.
+    </para>
+  </refsect1>
+
+  <refsect1>
+    <title>DHCPv6 Client Object</title>
+
+    <programlisting executable="systemd-networkd" node="/org/freedesktop/network1/link/_1" interface="org.freedesktop.network1.DHCPv6Client">
+node /org/freedesktop/network1/link/_1 {
+  interface org.freedesktop.network1.DHCPv6Client {
+    properties:
+      readonly s State = '...';
+  };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
+  interface org.freedesktop.network1.Link { ... };
+};
+    </programlisting>
+
+    <!--property State is not documented!-->
+
+    <!--Autogenerated cross-references for systemd.directives, do not edit-->
+
+    <variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.Link"/>
+
+    <variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.DHCPv6Client"/>
+
+    <variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.Link"/>
+
+    <variablelist class="dbus-interface" generated="True" extra-ref="org.freedesktop.network1.DHCPv6Client"/>
+
+    <variablelist class="dbus-property" generated="True" extra-ref="State"/>
+
+    <!--End of Autogenerated section-->
+
+    <para>
+      Provides information about DHCPv6 client status.
+    </para>
+  </refsect1>
+
   <refsect1>
     <title>Examples</title>
 
-- 
2.47.3