diff options
Diffstat (limited to 'lib/libc/net/getipnodebyname.3')
-rw-r--r-- | lib/libc/net/getipnodebyname.3 | 36 |
1 files changed, 12 insertions, 24 deletions
diff --git a/lib/libc/net/getipnodebyname.3 b/lib/libc/net/getipnodebyname.3 index b31fe33..f960957 100644 --- a/lib/libc/net/getipnodebyname.3 +++ b/lib/libc/net/getipnodebyname.3 @@ -75,12 +75,10 @@ and for specifying address family and operation mode. The additional arguments allow programmer to get address for a nodename, for specific address family -.Po -such as +(such as .Dv AF_INET or -.Dv AF_INET6 -.Pc . +.Dv AF_INET6 ) . The functions also require an additional pointer argument, .Ar error_num to return the appropriate error code, @@ -97,9 +95,7 @@ the .Ar name argument can be either a node name or a numeric address string -.Po -i.e., a dotted-decimal IPv4 address or an IPv6 hex address -.Pc . +(i.e., a dotted-decimal IPv4 address or an IPv6 hex address). The .Ar af argument specifies the address family, either @@ -112,7 +108,7 @@ argument specifies the types of addresses that are searched for, and the types of addresses that are returned. We note that a special flags value of .Dv AI_DEFAULT -.Pq defined below +(defined below) should handle most applications. That is, porting simple applications to use IPv6 replaces the call .Bd -literal -offset @@ -192,10 +188,8 @@ That is, if no records are found then a query is made for .Li A records and any found are returned as IPv4-mapped IPv6 addresses -.Po -.Li h_length -will be 16 -.Pc . +.Li ( h_length +will be 16). The .Dv AI_V4MAPPED flag is ignored unless @@ -284,9 +278,7 @@ We noted that the function must allow the .Ar name argument to be either a node name or a literal address string -.Po -i.e., a dotted-decimal IPv4 address or an IPv6 hex address -.Pc . +(i.e., a dotted-decimal IPv4 address or an IPv6 hex address). This saves applications from having to call .Xr inet_pton 3 to handle literal address strings. @@ -329,15 +321,11 @@ is a copy of the argument, .Li h_length is either 4 -.Po -for -.Dv AF_INET -.Pc +(for +.Dv AF_INET ) or 16 -.Po -for -.Dv AF_INET6 -.Pc , +(for +.Dv AF_INET6 ) , .Li h_addr_list[0] is a pointer to the 4-byte or 16-byte binary address, and @@ -453,7 +441,7 @@ and .Fn getipnodebyaddr are documented in .Dq Basic Socket Interface Extensions for IPv6 -.Pq RFC2553 . +(RFC2553). .\" .Sh BUGS .Fn getipnodebyname |