From: Maciej W. Rozycki Date: Wed, 4 Jun 2025 15:27:20 +0000 (+0100) Subject: manual: Document error codes missing for 'inet_pton' X-Git-Tag: glibc-2.42~166 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=140b20e9716b51659a5223b182dcf07ac62b3f77;p=thirdparty%2Fglibc.git 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 --- diff --git a/manual/socket.texi b/manual/socket.texi index e8285b9200..d804c7a48b 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})