From e1951e6f3509541cb6150add99b97aaf4dabcc82 Mon Sep 17 00:00:00 2001
From: Abhik Roy <abhik.roy@espressif.com>
Date: Wed, 27 May 2026 20:08:42 +1000
Subject: [PATCH] docs(lwip): clarify DNS_MAX_HOST_IP range and addr_cnt in
 Kconfig

---
 components/lwip/Kconfig | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/lwip/Kconfig b/components/lwip/Kconfig
index 608bf2493e2..c45c70afefb 100644
--- a/components/lwip/Kconfig
+++ b/components/lwip/Kconfig
@@ -1204,9 +1204,13 @@ menu "LWIP"
 
         config LWIP_DNS_MAX_HOST_IP
             int "Maximum number of IP addresses per host"
+            range 1 8
             default 1
             help
                 Maximum number of IP addresses that can be returned by DNS queries for a single host.
+                Allowed values are 1--8. In lwIP this is ``DNS_MAX_HOST_IP``. Multi-IP DNS APIs
+                require the caller's ``addr_cnt`` argument to satisfy 0 < addr_cnt <= DNS_MAX_HOST_IP;
+                otherwise they return ``ERR_ARG``.
 
         config LWIP_DNS_MAX_SERVERS
             int "Maximum number of DNS servers"