Adding upstream version 124.0.1.upstream/124.0.1

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 48 insertions, 0 deletions

diff --git a/docs/nspr/reference/pr_gethostbyname.rst b/docs/nspr/reference/pr_gethostbyname.rst
new file mode 100644
index 0000000000..f1a1a4a108
--- /dev/null
+++ b/docs/nspr/reference/pr_gethostbyname.rst
@@ -0,0 +1,48 @@
+PR_GetHostByName
+================
+
+Looks up a host by name.
+
+
+Syntax
+------
+
+.. code::
+
+   #include <prnetdb.h>
+
+   PRStatus PR_GetHostByName(
+     const char *hostname,
+     char *buf,
+     PRIntn bufsize,
+     PRHostEnt *hostentry);
+
+
+Parameters
+~~~~~~~~~~
+
+The function has the following parameters:
+
+``hostname``
+   The character string defining the host name of interest.
+``buf``
+   A pointer to a buffer, allocated by the caller, that is filled in
+   with host data on output. All of the pointers in the ``hostentry``
+   structure point to data saved in this buffer. This buffer is
+   referenced by the runtime during a call to :ref:`PR_EnumerateHostEnt`.
+``bufsize``
+   Number of bytes in the ``buf`` parameter. The buffer must be at least
+   :ref:`PR_NETDB_BUF_SIZE` bytes.
+``hostentry``
+   This structure is allocated by the caller. On output, this structure
+   is filled in by the runtime if the function returns ``PR_SUCCESS``.
+
+
+Returns
+~~~~~~~
+
+The function returns one of the following values:
+
+-  If successful, ``PR_SUCCESS``.
+-  If unsuccessful, ``PR_FAILURE``. You can retrieve the reason for the
+   failure by calling :ref:`PR_GetError`.