34 lines
1.4 KiB
Diff
34 lines
1.4 KiB
Diff
commit 140b20e9716b51659a5223b182dcf07ac62b3f77
|
|
Author: Maciej W. Rozycki <macro@redhat.com>
|
|
Date: Wed Jun 4 16:27:20 2025 +0100
|
|
|
|
manual: Document error codes missing for 'inet_pton'
|
|
|
|
Add documentation for EAFNOSUPPORT error code returned, and the possible
|
|
return values on non-success.
|
|
|
|
Reviewed-by: Florian Weimer <fweimer@redhat.com>
|
|
|
|
diff --git a/manual/socket.texi b/manual/socket.texi
|
|
index e2f00b82a81fec6f..ac7e9e8a93bd6ff5 100644
|
|
--- a/manual/socket.texi
|
|
+++ b/manual/socket.texi
|
|
@@ -1216,6 +1216,17 @@ either @code{AF_INET} or @code{AF_INET6}, as appropriate for the type of
|
|
address being converted. @var{cp} is a pointer to the input string, and
|
|
@var{buf} is a pointer to a buffer for the result. It is the caller's
|
|
responsibility to make sure the buffer is large enough.
|
|
+
|
|
+The return value is @code{1} on success and @code{0} if @var{cp} does not
|
|
+point to a valid address string for the address family @var{af} requested.
|
|
+On failure, the function's return value is @code{-1} and @code{errno} is
|
|
+set accordingly. The following @code{errno} values are specific to this
|
|
+function:
|
|
+
|
|
+@table @code
|
|
+@item EAFNOSUPPORT
|
|
+The address family requested is neither @code{AF_INET} nor @code{AF_INET6}.
|
|
+@end table
|
|
@end deftypefun
|
|
|
|
@deftypefun {const char *} inet_ntop (int @var{af}, const void *@var{cp}, char *@var{buf}, socklen_t @var{len})
|