diff --git a/core/network-interface.hpp b/core/network-interface.hpp
index e9be083..0034052 100644
--- a/core/network-interface.hpp
+++ b/core/network-interface.hpp
@@ -89,6 +89,7 @@
 }
 
 /** \brief List configured network interfaces on the system and their info
+ *  \warning invalid IP addresses (e.g., 0.0.0.0) may be returned in some environments
  */
 std::vector<NetworkInterfaceInfo>
 listNetworkInterfaces();