Update: Add documentation comments regarding problems observed with gethostbyaddr...

Valgrind reported still reachable memory under a Glibc system when the network is not connected while performing a DNS resolution operation.

There is nothing I can do about this other than recommending to use something other than Glibc such as musl-libc.

diff --git a/level_0/f_network/c/network.h b/level_0/f_network/c/network.h
index 7759aa6a82853ccf99ad9b85368d33c43ab52358..58d4034f54f43bab4b1163799fea9fd186174367 100644 (file)
--- a/level_0/f_network/c/network.h
+++ b/level_0/f_network/c/network.h
@@ -71,6 +71,10 @@ extern "C" {
  *
  * This is for the Domain Name and is not for the IP address digit itself.
  *
+ * Some libc implementation may not properly clean up after calling gethostbyaddr() under certain cases, like on error or DNS entry not found.
+ * This can result in still reachable memory when the program exists.
+ * This is the fault of the particular libc in use, but testing to rule this out should still be considered.
+ *
  * @param from
  *   The IP version 4 or version 6 family integer.
  * @param to
@@ -97,6 +101,10 @@ extern "C" {
  *
  * This is for the Domain Name and is not for the IP address digit itself.
  *
+ * Some libc implementation may not properly clean up after calling gethostbyname() under certain cases, like on error or DNS entry not found.
+ * This can result in still reachable memory when the program exists.
+ * This is the fault of the particular libc in use, but testing to rule this out should still be considered.
+ *
  * @param from
  *   The human-friendly IP Domain Name.
  * @param to