summaryrefslogtreecommitdiffstats
path: root/lib/libc/net
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libc/net')
-rw-r--r--lib/libc/net/if_indextoname.318
-rw-r--r--lib/libc/net/inet6_option_space.334
-rw-r--r--lib/libc/net/inet6_rthdr_space.318
-rw-r--r--lib/libc/net/resolver.33
4 files changed, 28 insertions, 45 deletions
diff --git a/lib/libc/net/if_indextoname.3 b/lib/libc/net/if_indextoname.3
index a0d4beb..adf82cb 100644
--- a/lib/libc/net/if_indextoname.3
+++ b/lib/libc/net/if_indextoname.3
@@ -57,11 +57,9 @@
.Fn if_freenameindex "struct if_nameindex *ptr"
.Sh DESCRIPTION
The functions map interface index to readable interface name
-.Po
-such as
-.Li ``lo0''
-.Pc
-, and vice versa.
+(such as
+.Dq Li lo0 ) ,
+and vice versa.
.Pp
.Fn if_nametoindex
converts readable interface name to interface index
@@ -76,13 +74,11 @@ argument must point to a buffer of at least
.Dv IF_NAMESIZE
bytes into which the interface name corresponding to the specified index is
returned.
-.Po
-.Dv IF_NAMESIZE
+.Dv ( IF_NAMESIZE
is also defined in
-.Li <net/if.h>
+.Aq Pa net/if.h
and its value includes a terminating null byte at the end of the
-interface name.
-.Pc
+interface name.)
This pointer is also the return value of the function.
If there is no interface corresponding to the specified index,
.Dv NULL
@@ -94,7 +90,7 @@ returns an array of
structures.
.Fa if_nametoindex
is also defined in
-.Li <net/if.h> ,
+.Aq Pa net/if.h ,
and is as follows:
.Bd -literal -offset
struct if_nameindex {
diff --git a/lib/libc/net/inet6_option_space.3 b/lib/libc/net/inet6_option_space.3
index 63cbfa5..8236548 100644
--- a/lib/libc/net/inet6_option_space.3
+++ b/lib/libc/net/inet6_option_space.3
@@ -81,17 +81,13 @@ ancillary data, including the
.Li cmsghdr
structure at the beginning,
and any padding at the end
-.Po
-to make its size a multiple of 8 bytes
-.Pc .
+(to make its size a multiple of 8 bytes).
The argument is the size of the structure defining the option,
which must include any pad bytes at the beginning
-.Po
-the value
+(the value
.Li y
in the alignment term
-.Dq Li xn + y
-.Pc ,
+.Dq Li "xn + y" ) ,
the type byte, the length byte, and the option data.
.Pp
Note: If multiple options are stored in a single ancillary data
@@ -181,17 +177,16 @@ before calling this function.
The option type must have a value from
.Li 2
to
-.Li 255 , inclusive.
-.Po
-.Li 0
+.Li 255 ,
+inclusive.
+.Li ( 0
and
.Li 1
are reserved for the
.Li Pad1
and
.Li PadN
-options, respectively.
-.Pc
+options, respectively.)
.Pp
The option data length must have a value between
.Li 0
@@ -249,12 +244,10 @@ initialized by
is the value of the option data length byte for this option.
This value is required as an argument to allow the function to
determine if padding must be appended at the end of the option.
-.Po
-The
+(The
.Fn inet6_option_append
function does not need a data length argument
-since the option data length must already be stored by the caller.
-.Pc
+since the option data length must already be stored by the caller.)
.Pp
.Fa multx
is the value
@@ -289,10 +282,8 @@ and
.Fa *tptrp
points to
the 8-bit option type field
-.Po
-which is followed by the 8-bit option
-data length, followed by the option data
-.Pc .
+(which is followed by the 8-bit option
+data length, followed by the option data).
If no more options remain
to be processed, the return value is
.Li -1
@@ -407,7 +398,8 @@ on an error.
.Pp
.Fn inet6_option_alloc
returns
-.Dv NULL on an error.
+.Dv NULL
+on an error.
.Pp
On errors,
.Fn inet6_option_next
diff --git a/lib/libc/net/inet6_rthdr_space.3 b/lib/libc/net/inet6_rthdr_space.3
index 26e5c35..2c3fd9c 100644
--- a/lib/libc/net/inet6_rthdr_space.3
+++ b/lib/libc/net/inet6_rthdr_space.3
@@ -212,10 +212,8 @@ When implemented, this should behave as follows.
.Pp
This function takes a Routing header that was received as ancillary
data
-.Po
-pointed to by the first argument,
-.Fa in
-.Pc
+(pointed to by the first argument,
+.Fa in )
and writes a new Routing
header that sends datagrams along the reverse of that route.
Both
@@ -238,10 +236,8 @@ The return value of the function is -1 upon an error.
.Ss inet6_rthdr_getaddr
This function returns a pointer to the IPv6 address specified by
.Fa index
-.Po
-which must have a value between 1 and the value returned by
-.Fn inet6_rthdr_segments
-.Pc
+(which must have a value between 1 and the value returned by
+.Fn inet6_rthdr_segments )
in the Routing header described by
.Fa cmsg .
An
@@ -255,11 +251,9 @@ Upon an error the return value of the function is
.Ss inet6_rthdr_getflags
This function returns the flags value specified by
.Fa index
-.Po
-which must
+(which must
have a value between 0 and the value returned by
-.Fn inet6_rthdr_segments
-.Pc
+.Fn inet6_rthdr_segments )
in the Routing header described by
.Fa cmsg .
For an IPv6 Type 0 Routing header the return value will be either
diff --git a/lib/libc/net/resolver.3 b/lib/libc/net/resolver.3
index dedcde1..1fb97f5 100644
--- a/lib/libc/net/resolver.3
+++ b/lib/libc/net/resolver.3
@@ -305,7 +305,8 @@ as the name is compressed.
If
.Em dnptr
is
-.Dv NULL, names are not compressed.
+.Dv NULL ,
+names are not compressed.
If
.Fa lastdnptr
is
OpenPOWER on IntegriCloud