From 6625eb9e447bdd12b074f082f7522ca8f4f463fe 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): document LWIP_DNS_MAX_HOST_IP range and addr_cnt
 usage

The DNS buffer overflow fix (esp-lwip@6233a1561) is already included in
release/v5.4 via 882843dbf83. This commit only adds Kconfig documentation
for the DNS_MAX_HOST_IP range and addr_cnt API contract.
---
 components/lwip/Kconfig | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/lwip/Kconfig b/components/lwip/Kconfig
index 4e6ea719b30..55a49ca5183 100644
--- a/components/lwip/Kconfig
+++ b/components/lwip/Kconfig
@@ -1193,9 +1193,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"