diff options
Diffstat (limited to 'lib/libc/net')
-rw-r--r-- | lib/libc/net/addr2ascii.3 | 9 | ||||
-rw-r--r-- | lib/libc/net/getaddrinfo.3 | 16 | ||||
-rw-r--r-- | lib/libc/net/getifaddrs.3 | 6 | ||||
-rw-r--r-- | lib/libc/net/getipnodebyname.3 | 36 | ||||
-rw-r--r-- | lib/libc/net/getnameinfo.3 | 14 | ||||
-rw-r--r-- | lib/libc/net/if_indextoname.3 | 2 | ||||
-rw-r--r-- | lib/libc/net/inet6_option_space.3 | 6 | ||||
-rw-r--r-- | lib/libc/net/inet6_rthdr_space.3 | 8 |
8 files changed, 41 insertions, 56 deletions
diff --git a/lib/libc/net/addr2ascii.3 b/lib/libc/net/addr2ascii.3 index b9f6fa9..4003a83 100644 --- a/lib/libc/net/addr2ascii.3 +++ b/lib/libc/net/addr2ascii.3 @@ -105,13 +105,16 @@ addresses in the specified family: .Bl -tag -width AF_INETxxxx -compact .It Dv AF_INET .Li struct in_addr -.Pq in Aq Pa netinet/in.h +(in +.Aq Pa netinet/in.h ) .It Dv AF_LINK .Li struct sockaddr_dl -.Pq in Aq Pa net/if_dl.h +(in +.Aq Pa net/if_dl.h ) .\" .It Dv AF_INET6 .\" .Li struct in6_addr -.\" .Pq in Aq Pa netinet6/in6.h +.\" (in +.\" .Aq Pa netinet6/in6.h ) .El .Sh RETURN VALUES The diff --git a/lib/libc/net/getaddrinfo.3 b/lib/libc/net/getaddrinfo.3 index 7dd98a1..cd73f28 100644 --- a/lib/libc/net/getaddrinfo.3 +++ b/lib/libc/net/getaddrinfo.3 @@ -107,9 +107,7 @@ A .Pf non Dv -NULL .Fa nodename string can be either a node name or a numeric host 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). A .Pf non Dv -NULL .Fa servname @@ -226,13 +224,13 @@ member of the structure, then the returned socket address structure will be ready for a call to .Fn connect -.Pq for a connection-oriented protocol +(for a connection-oriented protocol) or either .Fn connect , .Fn sendto , or .Fn sendmsg -.Pq for a connectionless protocol . +(for a connectionless protocol). In this case, if the .Fa nodename argument is a @@ -379,10 +377,8 @@ and allows cut-and-paste input of scoped addresses. At the moment the code supports only link-local addresses in this format. The scope identifier is hardcoded to name of hardware interface associated with the link, -.Po -such as -.Li ne0 -.Pc . +(such as +.Li ne0 ) . For example, .Dq Li fe80::1%ne0 , which means @@ -615,7 +611,7 @@ function is defined in .St -p1003.1g-2000 , and documented in .Dq Basic Socket Interface Extensions for IPv6 -.Pq RFC2553 . +(RFC2553). .\" .Sh BUGS The current implementation is not thread-safe. diff --git a/lib/libc/net/getifaddrs.3 b/lib/libc/net/getifaddrs.3 index a83e397..b1da0bc 100644 --- a/lib/libc/net/getifaddrs.3 +++ b/lib/libc/net/getifaddrs.3 @@ -114,11 +114,13 @@ field references address family specific data. For .Dv AF_LINK addresses it contains a pointer to the .Fa struct if_data -.Pq as defined in include file Aq Pa net/if.h +(as defined in include file +.Aq Pa net/if.h ) which contains various interface attributes and statistics. For all other address families, it contains a pointer to the .Fa struct ifa_data -.Pq as defined in include file Aq Pa net/if.h +(as defined in include file +.Aq Pa net/if.h ) which contains per-address interface statistics. .Pp The data returned by 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 diff --git a/lib/libc/net/getnameinfo.3 b/lib/libc/net/getnameinfo.3 index 6b4f02d..8dc026c 100644 --- a/lib/libc/net/getnameinfo.3 +++ b/lib/libc/net/getnameinfo.3 @@ -122,9 +122,7 @@ The first value is actually defined as the constant in recent versions of BIND's .Aq Pa arpa/nameser.h header -.Po -older versions of BIND define this constant to be 256 -.Pc +(older versions of BIND define this constant to be 256) and the second is a guess based on the services listed in the current Assigned Numbers RFC. .Pp @@ -143,12 +141,10 @@ bit .Dv NI_NUMERICHOST is set, or if the host's name cannot be located in the DNS, the numeric form of the host's address is returned instead of its name -.Po -e.g., by calling +(e.g., by calling .Fn inet_ntop instead of -.Fn getnodebyaddr -.Pc . +.Fn getnodebyaddr ) . If the .Fa flag bit @@ -158,7 +154,7 @@ is set, an error is returned if the host's name cannot be located in the DNS. If the flag bit .Dv NI_NUMERICSERV is set, the numeric form of the service address is returned -.Pq e.g., its port number +(e.g., its port number) instead of its name. The two .Dv NI_NUMERICxxx @@ -302,7 +298,7 @@ function is defined in .St -p1003.1g-2000 , and documented in .Dq Basic Socket Interface Extensions for IPv6 -.Pq RFC2553 . +(RFC2553). .\" .Sh BUGS The current implementation is not thread-safe. diff --git a/lib/libc/net/if_indextoname.3 b/lib/libc/net/if_indextoname.3 index adf82cb..29ae464 100644 --- a/lib/libc/net/if_indextoname.3 +++ b/lib/libc/net/if_indextoname.3 @@ -139,4 +139,4 @@ R. Gilligan, S. Thomson, J. Bound, and W. Stevens, The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit. .Sh STANDARDS These functions are defined in ``Basic Socket Interface Extensions for IPv6'' -.Pq RFC2533 . +(RFC2533). diff --git a/lib/libc/net/inet6_option_space.3 b/lib/libc/net/inet6_option_space.3 index c2338fc..726a41c 100644 --- a/lib/libc/net/inet6_option_space.3 +++ b/lib/libc/net/inet6_option_space.3 @@ -102,7 +102,7 @@ is the number of options to be stored in the object. This is of little consequence, since it is assumed that most Hop-by-Hop option headers and Destination option headers carry only one option -.Pq appendix B of [RFC-2460] . +(appendix B of [RFC-2460]). .\" .Ss inet6_option_init .Fn inet6_option_init @@ -171,7 +171,7 @@ field is immediately followed by the 8-bit option data length field, which is then followed immediately by the option data. The caller initializes these three fields -.Pq the type-length-value, or TLV +(the type-length-value, or TLV) before calling this function. .Pp The option type must have a value from @@ -439,7 +439,7 @@ The implementation first appeared in KAME advanced networking kit. The functions are documented in .Dq Advanced Sockets API for IPv6 -.Pq RFC2292 . +(RFC2292). .\" .Sh BUGS The text was shamelessly copied from RFC2292. diff --git a/lib/libc/net/inet6_rthdr_space.3 b/lib/libc/net/inet6_rthdr_space.3 index 2c3fd9c..d09bba6 100644 --- a/lib/libc/net/inet6_rthdr_space.3 +++ b/lib/libc/net/inet6_rthdr_space.3 @@ -106,7 +106,7 @@ header of the specified .Fa type containing the specified number of .Fa segments -.Pq addresses . +(addresses). For an IPv6 Type 0 Routing header, the number of segments must be between 1 and 23, inclusive. The return value includes the size of the cmsghdr structure that precedes the Routing @@ -218,14 +218,14 @@ and writes a new Routing header that sends datagrams along the reverse of that route. Both arguments are allowed to point to the same buffer -.Pq that is, the reversal can occur in place . +(that is, the reversal can occur in place). .Pp The return value of the function is 0 on success, or -1 upon an error. .\" .Ss inet6_rthdr_segments This function returns the number of segments -.Pq addresses +(addresses) contained in the Routing header described by .Fa cmsg . @@ -314,7 +314,7 @@ The implementation first appeared in KAME advanced networking kit. The functions are documented in .Dq Advanced Sockets API for IPv6 -.Pq RFC2292 . +(RFC2292). .\" .Sh BUGS The text was shamelessly copied from RFC2292. |