From: Bruno Haible <bruno@clisp.org>
Date: Mon, 19 Sep 2005 15:47:27 +0000 (+0000)
Subject: Note about inet_ntoa.
X-Git-Tag: cvs-readonly~2932
X-Git-Url: http://erislabs.org.uk/gitweb/?a=commitdiff_plain;h=d17a566b1ecd2c1fe07b846aa6720f874f3ab12d;p=gnulib.git

Note about inet_ntoa.
---

diff --git a/doc/inet_ntoa.texi b/doc/inet_ntoa.texi
new file mode 100644
index 000000000..e4ecda22f
--- /dev/null
+++ b/doc/inet_ntoa.texi
@@ -0,0 +1,13 @@
+@node inet_ntoa
+@section inet_ntoa
+@findex inet_ntoa
+
+The @code{inet_ntoa} function need not be reentrant, and consequently
+is not required to be thread safe.  Implementations of
+@code{inet_ntoa} typically write the time stamp into static buffer.
+If two threads call @code{inet_ntoa} at roughly the same time, you
+might end up with the wrong date in one of the threads, or some
+undefined string.  Further, @code{inet_ntoa} is specific for
+@acronym{IPv4} addresses.
+
+A protocol independent function is @code{inet_ntop}.