summaryrefslogtreecommitdiff
path: root/lib/libc/net
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libc/net')
-rw-r--r--lib/libc/net/ethers.310
-rw-r--r--lib/libc/net/eui64.312
-rw-r--r--lib/libc/net/getaddrinfo.320
-rw-r--r--lib/libc/net/getifaddrs.320
-rw-r--r--lib/libc/net/getifmaddrs.318
-rw-r--r--lib/libc/net/getipnodebyname.36
-rw-r--r--lib/libc/net/getnameinfo.320
-rw-r--r--lib/libc/net/hesiod.312
-rw-r--r--lib/libc/net/inet6_opt_init.314
-rw-r--r--lib/libc/net/inet6_option_space.312
-rw-r--r--lib/libc/net/inet6_rth_space.316
-rw-r--r--lib/libc/net/inet6_rthdr_space.312
-rw-r--r--lib/libc/net/rcmdsh.38
-rw-r--r--lib/libc/net/resolver.310
14 files changed, 95 insertions, 95 deletions
diff --git a/lib/libc/net/ethers.3 b/lib/libc/net/ethers.3
index 4f774e52ad14..a13244795fa4 100644
--- a/lib/libc/net/ethers.3
+++ b/lib/libc/net/ethers.3
@@ -187,6 +187,11 @@ file.
.Sh SEE ALSO
.Xr ethers 5 ,
.Xr yp 8
+.Sh HISTORY
+This particular implementation of the
+.Nm
+library functions were written for and first appeared in
+.Fx 2.1 .
.Sh BUGS
The
.Fn ether_aton
@@ -194,8 +199,3 @@ and
.Fn ether_ntoa
functions returns values that are stored in static memory areas
which may be overwritten the next time they are called.
-.Sh HISTORY
-This particular implementation of the
-.Nm
-library functions were written for and first appeared in
-.Fx 2.1 .
diff --git a/lib/libc/net/eui64.3 b/lib/libc/net/eui64.3
index 7a500dd09a38..3000c74e6d00 100644
--- a/lib/libc/net/eui64.3
+++ b/lib/libc/net/eui64.3
@@ -215,6 +215,12 @@ file.
.Xr firewire 4 ,
.Xr eui64 5 ,
.Xr yp 8
+.Sh HISTORY
+These functions first appears in
+.Fx 5.3 .
+They are derived from the
+.Xr ethers 3
+family of functions.
.Sh BUGS
The
.Fn eui64_aton
@@ -222,9 +228,3 @@ and
.Fn eui64_ntoa
functions returns values that are stored in static memory areas
which may be overwritten the next time they are called.
-.Sh HISTORY
-These functions first appears in
-.Fx 5.3 .
-They are derived from the
-.Xr ethers 3
-family of functions.
diff --git a/lib/libc/net/getaddrinfo.3 b/lib/libc/net/getaddrinfo.3
index e44a94711277..e72fb25c72e8 100644
--- a/lib/libc/net/getaddrinfo.3
+++ b/lib/libc/net/getaddrinfo.3
@@ -397,6 +397,13 @@ The current implementation assumes a one-to-one relationship between
interfaces and links, which is not necessarily true according to the
specification.
.\"
+.Sh FILES
+.Bl -tag -width /etc/nsswitch.conf -compact
+.It Pa /etc/hosts
+.It Pa /etc/nsswitch.conf
+.It Pa /etc/resolv.conf
+.El
+.\"
.Sh EXAMPLES
The following code tries to connect to
.Dq Li www.kame.net
@@ -504,13 +511,6 @@ if (nsock == 0) {
freeaddrinfo(res0);
.Ed
.\"
-.Sh FILES
-.Bl -tag -width /etc/nsswitch.conf -compact
-.It Pa /etc/hosts
-.It Pa /etc/nsswitch.conf
-.It Pa /etc/resolv.conf
-.El
-.\"
.Sh DIAGNOSTICS
Error return status from
.Fn getaddrinfo
@@ -606,9 +606,6 @@ indicate an unknown error.
.%D June 2000
.Re
.\"
-.Sh HISTORY
-The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit.
-.\"
.Sh STANDARDS
The
.Fn getaddrinfo
@@ -618,6 +615,9 @@ and documented in
.Dq Basic Socket Interface Extensions for IPv6
(RFC2553).
.\"
+.Sh HISTORY
+The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit.
+.\"
.Sh BUGS
Although the current implementation is otherwise thread-safe, using
.Fn getaddrinfo
diff --git a/lib/libc/net/getifaddrs.3 b/lib/libc/net/getifaddrs.3
index 83877239aa39..29ea50c7bd73 100644
--- a/lib/libc/net/getifaddrs.3
+++ b/lib/libc/net/getifaddrs.3
@@ -142,16 +142,6 @@ for any of the errors specified for the library routines
.Xr malloc 3
or
.Xr sysctl 3 .
-.Sh BUGS
-If both
-.In net/if.h
-and
-.In ifaddrs.h
-are being included,
-.In net/if.h
-.Em must
-be included before
-.In ifaddrs.h .
.Sh SEE ALSO
.Xr ioctl 2 ,
.Xr socket 2 ,
@@ -163,3 +153,13 @@ The
.Nm
implementation first appeared in BSDi
.Bsx .
+.Sh BUGS
+If both
+.In net/if.h
+and
+.In ifaddrs.h
+are being included,
+.In net/if.h
+.Em must
+be included before
+.In ifaddrs.h .
diff --git a/lib/libc/net/getifmaddrs.3 b/lib/libc/net/getifmaddrs.3
index 613a187eabed..2d2a93681297 100644
--- a/lib/libc/net/getifmaddrs.3
+++ b/lib/libc/net/getifmaddrs.3
@@ -95,6 +95,15 @@ for any of the errors specified for the library routines
.Xr malloc 3
or
.Xr sysctl 3 .
+.Sh SEE ALSO
+.Xr sysctl 3 ,
+.Xr networking 4 ,
+.Xr ifconfig 8
+.Sh HISTORY
+The
+.Fn getifmaddrs
+function first appeared in
+.Fx 5.2 .
.Sh BUGS
If both
.In net/if.h
@@ -105,12 +114,3 @@ are being included,
.Em must
be included before
.In ifaddrs.h .
-.Sh SEE ALSO
-.Xr sysctl 3 ,
-.Xr networking 4 ,
-.Xr ifconfig 8
-.Sh HISTORY
-The
-.Fn getifmaddrs
-function first appeared in
-.Fx 5.2 .
diff --git a/lib/libc/net/getipnodebyname.3 b/lib/libc/net/getipnodebyname.3
index 241b6fac22f7..d9de5bf6fc24 100644
--- a/lib/libc/net/getipnodebyname.3
+++ b/lib/libc/net/getipnodebyname.3
@@ -447,9 +447,6 @@ The meanings of each error code are described in
.%D March 1999
.Re
.\"
-.Sh HISTORY
-The implementation first appeared in KAME advanced networking kit.
-.\"
.Sh STANDARDS
The
.Fn getipnodebyname
@@ -460,6 +457,9 @@ are documented in
.Dq Basic Socket Interface Extensions for IPv6
(RFC2553).
.\"
+.Sh HISTORY
+The implementation first appeared in KAME advanced networking kit.
+.\"
.Sh BUGS
Although the current implementation is otherwise thread-safe, using
it in conjunction with
diff --git a/lib/libc/net/getnameinfo.3 b/lib/libc/net/getnameinfo.3
index 796531831a92..56918152fb90 100644
--- a/lib/libc/net/getnameinfo.3
+++ b/lib/libc/net/getnameinfo.3
@@ -187,6 +187,13 @@ Refer to
.Xr getaddrinfo 3
for the notation.
.\"
+.Sh FILES
+.Bl -tag -width /etc/nsswitch.conf -compact
+.It Pa /etc/hosts
+.It Pa /etc/nsswitch.conf
+.It Pa /etc/resolv.conf
+.El
+.\"
.Sh EXAMPLES
The following code tries to get numeric hostname, and service name,
for given socket address.
@@ -216,13 +223,6 @@ if (getnameinfo(sa, sa->sa_len, hbuf, sizeof(hbuf), NULL, 0,
printf("host=%s\\n", hbuf);
.Ed
.\"
-.Sh FILES
-.Bl -tag -width /etc/nsswitch.conf -compact
-.It Pa /etc/hosts
-.It Pa /etc/nsswitch.conf
-.It Pa /etc/resolv.conf
-.El
-.\"
.Sh DIAGNOSTICS
The function indicates successful completion by a zero return value;
a non-zero return value indicates failure.
@@ -284,9 +284,6 @@ The error code can be found in errno.
.%D June 2000
.Re
.\"
-.Sh HISTORY
-The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit.
-.\"
.Sh STANDARDS
The
.Fn getaddrinfo
@@ -296,6 +293,9 @@ and documented in
.Dq Basic Socket Interface Extensions for IPv6
(RFC2553).
.\"
+.Sh HISTORY
+The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit.
+.\"
.Sh BUGS
Though the current implementation should be thread-safe, using
.Fn getnameinfo
diff --git a/lib/libc/net/hesiod.3 b/lib/libc/net/hesiod.3
index d91db9ed805b..bae4e4419f82 100644
--- a/lib/libc/net/hesiod.3
+++ b/lib/libc/net/hesiod.3
@@ -113,12 +113,6 @@ If the environment variable
.Ev HESIOD_CONFIG
is set, it specifies the location of the Hesiod configuration file.
.El
-.Sh SEE ALSO
-.Xr hesiod.conf 5 ,
-.Xr named 8
-.Rs
-.%T "Hesiod - Project Athena Technical Plan -- Name Service"
-.Re
.Sh ERRORS
Hesiod calls may fail because of:
.Bl -tag -width Er
@@ -159,6 +153,12 @@ argument had a domain extension which could not be resolved with type
.Dq rhs\-extension
in the local Hesiod domain.
.El
+.Sh SEE ALSO
+.Xr hesiod.conf 5 ,
+.Xr named 8
+.Rs
+.%T "Hesiod - Project Athena Technical Plan -- Name Service"
+.Re
.Sh AUTHORS
.An Steve Dyer ,
IBM/Project Athena
diff --git a/lib/libc/net/inet6_opt_init.3 b/lib/libc/net/inet6_opt_init.3
index 88dd4837c704..e3970993aab5 100644
--- a/lib/libc/net/inet6_opt_init.3
+++ b/lib/libc/net/inet6_opt_init.3
@@ -279,17 +279,17 @@ multiple fields.
Robust receivers might want to verify alignment before calling
this function.
.\"
-.Sh DIAGNOSTICS
-All the functions return
-\-1
-on an error.
-.\"
.Sh EXAMPLES
draft-ietf-ipngwg-rfc2292bis-08.txt
gives comprehensive examples in Section 23.
.Pp
KAME also provides examples in the advapitest directory of its kit.
.\"
+.Sh DIAGNOSTICS
+All the functions return
+\-1
+on an error.
+.\"
.Sh SEE ALSO
.Rs
.%A W. Stevens
@@ -307,13 +307,13 @@ KAME also provides examples in the advapitest directory of its kit.
.%N RFC2460
.%D December 1998
.Re
-.Sh HISTORY
-The implementation first appeared in KAME advanced networking kit.
.Sh STANDARDS
The functions
are documented in
.Dq Advanced Sockets API for IPv6
.Pq draft-ietf-ipngwg-rfc2292bis-08.txt .
.\"
+.Sh HISTORY
+The implementation first appeared in KAME advanced networking kit.
.Sh BUGS
The text was shamelessly copied from internet-drafts for RFC2292bis.
diff --git a/lib/libc/net/inet6_option_space.3 b/lib/libc/net/inet6_option_space.3
index 15374b85e974..cf49fdf6d587 100644
--- a/lib/libc/net/inet6_option_space.3
+++ b/lib/libc/net/inet6_option_space.3
@@ -422,6 +422,9 @@ and
is not
.Dv NULL .
.\"
+.Sh EXAMPLES
+RFC2292 gives comprehensive examples in chapter 6.
+.\"
.Sh DIAGNOSTICS
The
.Fn inet6_option_init
@@ -453,9 +456,6 @@ to non
.Dv NULL
value.
.\"
-.Sh EXAMPLES
-RFC2292 gives comprehensive examples in chapter 6.
-.\"
.Sh SEE ALSO
.Rs
.%A W. Stevens
@@ -472,14 +472,14 @@ RFC2292 gives comprehensive examples in chapter 6.
.%D December 1998
.Re
.\"
-.Sh HISTORY
-The implementation first appeared in KAME advanced networking kit.
-.\"
.Sh STANDARDS
The functions
are documented in
.Dq Advanced Sockets API for IPv6
(RFC2292).
.\"
+.Sh HISTORY
+The implementation first appeared in KAME advanced networking kit.
+.\"
.Sh BUGS
The text was shamelessly copied from RFC2292.
diff --git a/lib/libc/net/inet6_rth_space.3 b/lib/libc/net/inet6_rth_space.3
index 34e3f26a8626..e10d8e5c2093 100644
--- a/lib/libc/net/inet6_rth_space.3
+++ b/lib/libc/net/inet6_rth_space.3
@@ -217,6 +217,12 @@ to obtain the number of segments in the Routing header.
Upon an error the return value of the function is
.Dv NULL .
.\"
+.Sh EXAMPLES
+draft-ietf-ipngwg-rfc2292bis-08.txt
+gives comprehensive examples in Section 22.
+.Pp
+KAME also provides examples in the advapitest directory of its kit.
+.\"
.Sh DIAGNOSTICS
The
.Fn inet6_rth_space
@@ -238,12 +244,6 @@ and
functions
return 0 on success, or \-1 upon an error.
.\"
-.Sh EXAMPLES
-draft-ietf-ipngwg-rfc2292bis-08.txt
-gives comprehensive examples in Section 22.
-.Pp
-KAME also provides examples in the advapitest directory of its kit.
-.\"
.Sh SEE ALSO
.Rs
.%A W. Stevens
@@ -261,13 +261,13 @@ KAME also provides examples in the advapitest directory of its kit.
.%N RFC2460
.%D December 1998
.Re
-.Sh HISTORY
-The implementation first appeared in KAME advanced networking kit.
.Sh STANDARDS
The functions
are documented in
.Dq Advanced Sockets API for IPv6
.Pq draft-ietf-ipngwg-rfc2292bis-08.txt .
.\"
+.Sh HISTORY
+The implementation first appeared in KAME advanced networking kit.
.Sh BUGS
The text was shamelessly copied from internet-drafts for RFC2292bis.
diff --git a/lib/libc/net/inet6_rthdr_space.3 b/lib/libc/net/inet6_rthdr_space.3
index 9c3e5be85fd5..4de2359a2898 100644
--- a/lib/libc/net/inet6_rthdr_space.3
+++ b/lib/libc/net/inet6_rthdr_space.3
@@ -268,6 +268,9 @@ Upon an error the return value of the function is -1.
Note: Addresses are indexed starting at 1, and flags starting at 0,
to maintain consistency with the terminology and figures in RFC2460.
.\"
+.Sh EXAMPLES
+RFC2292 gives comprehensive examples in chapter 8.
+.\"
.Sh DIAGNOSTICS
The
.Fn inet6_rthdr_space
@@ -298,9 +301,6 @@ and
functions
return -1 on error.
.\"
-.Sh EXAMPLES
-RFC2292 gives comprehensive examples in chapter 8.
-.\"
.Sh SEE ALSO
.Rs
.%A W. Stevens
@@ -317,15 +317,15 @@ RFC2292 gives comprehensive examples in chapter 8.
.%D December 1998
.Re
.\"
-.Sh HISTORY
-The implementation first appeared in KAME advanced networking kit.
-.\"
.Sh STANDARDS
The functions
are documented in
.Dq Advanced Sockets API for IPv6
(RFC2292).
.\"
+.Sh HISTORY
+The implementation first appeared in KAME advanced networking kit.
+.\"
.Sh BUGS
The text was shamelessly copied from RFC2292.
.Pp
diff --git a/lib/libc/net/rcmdsh.3 b/lib/libc/net/rcmdsh.3
index 91b81b98e7fe..03e7dabb4243 100644
--- a/lib/libc/net/rcmdsh.3
+++ b/lib/libc/net/rcmdsh.3
@@ -107,10 +107,6 @@ and a diagnostic message is printed on the standard error.
.Xr socketpair 2 ,
.Xr rcmd 3 ,
.Xr rshd 8
-.Sh BUGS
-If
-.Xr rsh 1
-encounters an error, a file descriptor is still returned instead of \-1.
.Sh HISTORY
The
.Fn rcmdsh
@@ -118,3 +114,7 @@ function first appeared in
.Ox 2.0 ,
and made its way into
.Fx 4.6 .
+.Sh BUGS
+If
+.Xr rsh 1
+encounters an error, a file descriptor is still returned instead of \-1.
diff --git a/lib/libc/net/resolver.3 b/lib/libc/net/resolver.3
index 49257bf7b7a9..a736db93686e 100644
--- a/lib/libc/net/resolver.3
+++ b/lib/libc/net/resolver.3
@@ -399,17 +399,17 @@ function puts a 32-bit quantity
.Fa src
to a buffer pointed to by
.Fa dst .
-.Sh RETURN VALUES
-The
-.Fn res_init
-function will return 0 on success, or \-1 in a threaded program if
-per-thread storage could not be allocated.
.Sh IMPLEMENTATION NOTES
This implementation of the resolver is thread-safe, but it will not
function properly if the programmer attempts to declare his or her own
.Va _res
structure in an attempt to replace the per-thread version referred to
by that macro.
+.Sh RETURN VALUES
+The
+.Fn res_init
+function will return 0 on success, or \-1 in a threaded program if
+per-thread storage could not be allocated.
.Sh FILES
.Bl -tag -width /etc/resolv.conf
.It Pa /etc/resolv.conf
generated by cgit v1.2.3 (git 2.25.1) at 2025-11-04 11:10:30 +0000