ares_inet_ntop.3 (1346B)
1 .\" 2 .\" Copyright (C) 2013 by Daniel Stenberg 3 .\" SPDX-License-Identifier: MIT 4 .\" 5 .TH ARES_INET_NTOP 3 "17 Feb 2013" 6 .SH NAME 7 ares_inet_ntop \- convert a network format address to presentation format 8 .SH SYNOPSIS 9 .nf 10 #include <ares.h> 11 12 const char *ares_inet_ntop(int \fIaf\fP, const void *\fIsrc\fP, char *\fIdst\fP, 13 ares_socklen_t \fIsize\fP); 14 .fi 15 .SH DESCRIPTION 16 This is a portable version with the identical functionality of the commonly 17 available \fIinet_ntop\fP. 18 19 The ares_inet_ntop() function converts a numeric address into a text string 20 suitable for presentation. The \fBaf\fP argument shall specify the family of 21 the address. This can be AF_INET or AF_INET6. The \fBsrc\fP argument points 22 to a buffer holding an IPv4 address if the af argument is AF_INET, or an IPv6 23 address if the af argument is AF_INET6; the address must be in network byte 24 order. The \fBdst\fP argument points to a buffer where the function stores the 25 resulting text string; it shall not be NULL. The \fBsize\fP argument specifies 26 the size of this buffer, which shall be large enough to hold the text string 27 (INET_ADDRSTRLEN (16) characters for IPv4, INET6_ADDRSTRLEN (46) characters 28 for IPv6). 29 .SH SEE ALSO 30 .BR ares_init (3), 31 .BR ares_inet_pton (3) 32 .SH AVAILABILITY 33 made properly publicly available in c-ares for real in version 1.10.0 34