From 792b0a07dc6d762e025ab3a507954fa8ecc0a234 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vin=C3=ADcius=20Ferr=C3=A3o?=
 <2031761+viniciusferrao@users.noreply.github.com>
Date: Thu, 23 Apr 2026 14:12:08 -0300
Subject: [PATCH] Clarify Kea live DHCP operations in makedhcp docs

---
 .../guides/admin-guides/references/man8/makedhcp.8.rst   | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/docs/source/guides/admin-guides/references/man8/makedhcp.8.rst b/docs/source/guides/admin-guides/references/man8/makedhcp.8.rst
index 877ff828f..9e586e09f 100644
--- a/docs/source/guides/admin-guides/references/man8/makedhcp.8.rst
+++ b/docs/source/guides/admin-guides/references/man8/makedhcp.8.rst
@@ -68,7 +68,12 @@ The ``auto`` setting keeps ISC DHCP on platforms where it is still available and
 4.
  
  Then run \ **makedhcp**\  with a noderange or the \ **-a**\  option.  This will inject DHCP configuration data pertinent to the specified nodes.
- With ISC DHCP, Linux node entries are updated through OMAPI. With Kea DHCP, node reservations are rendered into the Kea JSON configuration, validated, and the Kea service is restarted.
+ With ISC DHCP, Linux node entries are updated through OMAPI and ``omshell``.
+ With Kea DHCP, xCAT stores node reservations in the Kea JSON configuration and,
+ when the Kea Control Agent and host-commands hook are enabled, performs live
+ reservation add and delete operations through the Kea control API. If the live
+ control path is unavailable, xCAT validates the updated Kea configuration and
+ restarts the Kea services.
  
 
 
@@ -88,7 +93,7 @@ OPTIONS
  The \ **makedhcp**\  command will automatically restart the dhcp daemon after this operation.
  This option will replace any existing configuration file (making a backup of it first).
  For Linux systems using ISC DHCP, the file will include network entries as well as certain general parameters such as a dynamic range and omapi configuration.
- For Linux systems using Kea DHCP, the generated files are ``/etc/kea/kea-dhcp4.conf``, ``/etc/kea/kea-dhcp6.conf`` when IPv6 networks are configured, and ``/etc/kea/kea-dhcp-ddns.conf`` when DDNS is enabled.
+ For Linux systems using Kea DHCP, the generated files are ``/etc/kea/kea-dhcp4.conf``, ``/etc/kea/kea-dhcp6.conf`` when IPv6 networks are configured, ``/etc/kea/kea-ctrl-agent.conf`` when the Kea Control Agent is enabled, and ``/etc/kea/kea-dhcp-ddns.conf`` when DDNS is enabled.
  For AIX systems the file will include network entries.
  On AIX systems, if there are any non-xCAT entries in the existing configuration file they will be preserved and added to the end of the new configuration file.