summaryrefslogtreecommitdiffstats
path: root/lib/libc/net/getipnodebyname.3
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2001-08-07 15:48:51 +0000
committerru <ru@FreeBSD.org>2001-08-07 15:48:51 +0000
commit43457588767caedd16dbf19162de0a6a435dfeda (patch)
tree0505e005ecc9492a4b759dc8e06eb138613e4aa4 /lib/libc/net/getipnodebyname.3
parent6b00d6a3ebd552afe7b0a0844e598ee70810f887 (diff)
downloadFreeBSD-src-43457588767caedd16dbf19162de0a6a435dfeda.zip
FreeBSD-src-43457588767caedd16dbf19162de0a6a435dfeda.tar.gz
mdoc(7) police:
Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
Diffstat (limited to 'lib/libc/net/getipnodebyname.3')
-rw-r--r--lib/libc/net/getipnodebyname.336
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
OpenPOWER on IntegriCloud