summaryrefslogtreecommitdiff
path: root/lib/libc/net
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libc/net')
-rw-r--r--lib/libc/net/byteorder.315
-rw-r--r--lib/libc/net/ethers.320
-rw-r--r--lib/libc/net/gethostbyname.38
-rw-r--r--lib/libc/net/getifaddrs.35
-rw-r--r--lib/libc/net/getnameinfo.34
-rw-r--r--lib/libc/net/getnetent.315
-rw-r--r--lib/libc/net/getprotoent.35
-rw-r--r--lib/libc/net/getservent.35
-rw-r--r--lib/libc/net/inet.345
-rw-r--r--lib/libc/net/inet6_rthdr_space.39
-rw-r--r--lib/libc/net/inet_net.36
-rw-r--r--lib/libc/net/link_addr.34
-rw-r--r--lib/libc/net/net_addrcmp.39
-rw-r--r--lib/libc/net/rcmd.315
14 files changed, 96 insertions, 69 deletions
diff --git a/lib/libc/net/byteorder.3 b/lib/libc/net/byteorder.3
index 64a13d47baf..9d8fa7221f9 100644
--- a/lib/libc/net/byteorder.3
+++ b/lib/libc/net/byteorder.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: byteorder.3,v 1.7 1999/07/05 04:40:59 aaron Exp $
+.\" $OpenBSD: byteorder.3,v 1.8 2000/04/18 03:01:30 aaron Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -83,7 +83,8 @@
.Fn swap16 "u_int16_t val16"
.Sh DESCRIPTION
These routines convert 16- and 32-bit quantities between different
-byte orderings. The
+byte orderings.
+The
.Dq swap
functions reverse the byte ordering of
the given quantity, the others converts either from/to the native
@@ -127,7 +128,8 @@ The swap functions are of the form: swap{size}.
Names involving
.Sq n
convert quantities between network
-byte order and host byte order. The last letter
+byte order and host byte order.
+The last letter
.Pf ( Sq s
or
.Sq l )
@@ -136,7 +138,8 @@ for the traditional names for such quantities,
.Li short
and
.Li long ,
-respectively. Today, the C concept of
+respectively.
+Today, the C concept of
.Li short
and
.Li long
@@ -176,5 +179,5 @@ functions appeared in
.Bx 4.2 .
.Sh BUGS
On the vax, alpha, i386, and so far mips,
-bytes are handled backwards from most everyone else in
-the world. This is not expected to be fixed in the near future.
+bytes are handled backwards from most everyone else in the world.
+This is not expected to be fixed in the near future.
diff --git a/lib/libc/net/ethers.3 b/lib/libc/net/ethers.3
index 39968f3e65e..8c5066a7602 100644
--- a/lib/libc/net/ethers.3
+++ b/lib/libc/net/ethers.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ethers.3,v 1.11 1999/07/05 04:40:59 aaron Exp $
+.\" $OpenBSD: ethers.3,v 1.12 2000/04/18 03:01:31 aaron Exp $
.\"
.\" Written by roland@frob.com. Public domain.
.\"
@@ -41,15 +41,15 @@ function converts this structure into an
string of the form
.Dq xx:xx:xx:xx:xx:xx ,
consisting of 6 hexadecimal numbers separated
-by colons. It returns a pointer to a static buffer that is reused for
-each call.
+by colons.
+It returns a pointer to a static buffer that is reused for each call.
The
.Fn ether_aton
converts an
.Tn ASCII
string of the same form and to a structure
-containing the 6 octets of the address. It returns a pointer to a
-static structure that is reused for each call.
+containing the 6 octets of the address.
+It returns a pointer to a static structure that is reused for each call.
.Pp
The
.Fn ether_ntohost
@@ -61,13 +61,15 @@ addresses,
The
.Fn ether_ntohost
function looks up the given Ethernet address and writes the associated
-host name into the character buffer passed. This buffer should be
+host name into the character buffer passed.
+This buffer should be
.Dv MAXHOSTNAMELEN
characters in size.
The
.Fn ether_hostton
function looks up the given host name and writes the associated
-Ethernet address into the structure passed. Both functions return
+Ethernet address into the structure passed.
+Both functions return
zero if they find the requested host name or address, and \-1 if not.
.Pp
Each call reads
@@ -90,8 +92,8 @@ function parses a line from the
.Pa /etc/ethers
file and fills in the passed
.Li struct ether_addr
-and character buffer with the Ethernet address and host name on the line. It
-returns zero if the line was successfully parsed and \-1 if not.
+and character buffer with the Ethernet address and host name on the line.
+It returns zero if the line was successfully parsed and \-1 if not.
The character buffer should be
.Dv MAXHOSTNAMELEN
characters in size.
diff --git a/lib/libc/net/gethostbyname.3 b/lib/libc/net/gethostbyname.3
index aced5ba6167..f1353288c51 100644
--- a/lib/libc/net/gethostbyname.3
+++ b/lib/libc/net/gethostbyname.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: gethostbyname.3,v 1.14 2000/04/15 02:15:22 aaron Exp $
+.\" $OpenBSD: gethostbyname.3,v 1.15 2000/04/18 03:01:31 aaron Exp $
.\"
.\" Copyright (c) 1983, 1987, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -166,12 +166,14 @@ connection.
.Pp
The
.Fn herror
-function prints an error message describing the failure. If its argument
+function prints an error message describing the failure.
+If its argument
.Fa string
is non-null,
it is prepended to the message string and separated from it by a colon
.Pq Ql \&:
-and a space. The error message is printed with a trailing newline.
+and a space.
+The error message is printed with a trailing newline.
The contents of the error message is the same as that returned by
.Fn hstrerror
with argument
diff --git a/lib/libc/net/getifaddrs.3 b/lib/libc/net/getifaddrs.3
index fd36edb3cf6..d69e0f62f53 100644
--- a/lib/libc/net/getifaddrs.3
+++ b/lib/libc/net/getifaddrs.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getifaddrs.3,v 1.5 2000/04/16 13:48:53 itojun Exp $
+.\" $OpenBSD: getifaddrs.3,v 1.6 2000/04/18 03:01:31 aaron Exp $
.\" BSDI getifaddrs.3,v 2.5 2000/02/23 14:51:59 dab Exp
.\"
.\" Copyright (c) 1995, 1999
@@ -96,7 +96,8 @@ References the destination address on a P2P interface,
if one exists, otherwise it is
.Dv NULL .
.It Fa ifa_data
-References address family specific data. For
+References address family specific data.
+For
.Dv AF_LINK
addresses it contains a pointer to the
.Li struct if_data
diff --git a/lib/libc/net/getnameinfo.3 b/lib/libc/net/getnameinfo.3
index 8aee0716026..74690d0e416 100644
--- a/lib/libc/net/getnameinfo.3
+++ b/lib/libc/net/getnameinfo.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getnameinfo.3,v 1.5 2000/01/17 08:20:28 deraadt Exp $
+.\" $OpenBSD: getnameinfo.3,v 1.6 2000/04/18 03:01:31 aaron Exp $
.\"
.\" Copyright (c) 1983, 1987, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -102,7 +102,7 @@ or
.Fa servlen
arguments.
Otherwise, the caller must provide buffers large enough to hold the
-nodename and the service name, including the terminating null characters.
+nodename and the service name, including the terminating null characters.
.Pp
Unfortunately most systems do not provide constants that specify the
maximum size of either a fully-qualified domain name or a service name.
diff --git a/lib/libc/net/getnetent.3 b/lib/libc/net/getnetent.3
index 05478afdfbb..fba5505fec0 100644
--- a/lib/libc/net/getnetent.3
+++ b/lib/libc/net/getnetent.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getnetent.3,v 1.8 1999/07/05 04:40:59 aaron Exp $
+.\" $OpenBSD: getnetent.3,v 1.9 2000/04/18 03:01:31 aaron Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -84,8 +84,8 @@ A zero-terminated list of alternate names for the network.
The type of the network number returned; currently only
.Dv AF_INET .
.It Fa n_net
-The network number. Network numbers are returned in machine byte
-order.
+The network number.
+Network numbers are returned in machine byte order.
.El
.Pp
The
@@ -96,7 +96,8 @@ reads the next line of the file, opening the file if necessary.
The
.Fn setnetent
function
-opens and rewinds the file. If the
+opens and rewinds the file.
+If the
.Fa stayopen
flag is non-zero,
the net data base will not be closed after each call to
@@ -146,6 +147,6 @@ functions appeared in
.Sh BUGS
The data space used by these functions is static; if future use
requires the data, it should be copied before any subsequent calls
-to these functions overwrite it. Only Internet network numbers
-are currently understood. Expecting network numbers to fit in no
-more than 32 bits is naive.
+to these functions overwrite it.
+Only Internet network numbers are currently understood.
+Expecting network numbers to fit in no more than 32 bits is naive.
diff --git a/lib/libc/net/getprotoent.3 b/lib/libc/net/getprotoent.3
index 01f752ad5ff..e4e7e6ec45c 100644
--- a/lib/libc/net/getprotoent.3
+++ b/lib/libc/net/getprotoent.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getprotoent.3,v 1.5 1999/07/05 04:40:59 aaron Exp $
+.\" $OpenBSD: getprotoent.3,v 1.6 2000/04/18 03:01:32 aaron Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -92,7 +92,8 @@ reads the next line of the file, opening the file if necessary.
The
.Fn setprotoent
function
-opens and rewinds the file. If the
+opens and rewinds the file.
+If the
.Fa stayopen
flag is non-zero,
the net data base will not be closed after each call to
diff --git a/lib/libc/net/getservent.3 b/lib/libc/net/getservent.3
index 3ef95fb817a..21591cdcbba 100644
--- a/lib/libc/net/getservent.3
+++ b/lib/libc/net/getservent.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getservent.3,v 1.8 1999/07/05 04:40:59 aaron Exp $
+.\" $OpenBSD: getservent.3,v 1.9 2000/04/18 03:01:32 aaron Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -96,7 +96,8 @@ reads the next line of the file, opening the file if necessary.
The
.Fn setservent
function
-opens and rewinds the file. If the
+opens and rewinds the file.
+If the
.Fa stayopen
flag is non-zero,
the net data base will not be closed after each call to
diff --git a/lib/libc/net/inet.3 b/lib/libc/net/inet.3
index 1e38bdc0560..eb95f6c364a 100644
--- a/lib/libc/net/inet.3
+++ b/lib/libc/net/inet.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: inet.3,v 1.8 1999/07/05 04:40:59 aaron Exp $
+.\" $OpenBSD: inet.3,v 1.9 2000/04/18 03:01:32 aaron Exp $
.\" $NetBSD: inet.3,v 1.7 1997/06/18 02:25:24 lukem Exp $
.\"
.\" Copyright (c) 1983, 1990, 1991, 1993
@@ -85,12 +85,13 @@ The
function converts a presentation format address (that is, printable form
as held in a character string) to network format (usually a
.Li struct in_addr
-or some other internal binary representation, in network byte order). It
-returns 1 if the address was valid for the specified address family, or
+or some other internal binary representation, in network byte order).
+It returns 1 if the address was valid for the specified address family, or
0 if the address wasn't parseable in the specified address family, or \-1
if some system error occurred (in which case
.Va errno
-will have been set). This function is presently valid for
+will have been set).
+This function is presently valid for
.Dv AF_INET
and
.Dv AF_INET6 .
@@ -113,7 +114,8 @@ The function
converts an address from network format (usually a
.Li struct in_addr
or some other binary form, in network byte order) to presentation format
-(suitable for external display purposes). It returns
+(suitable for external display purposes).
+It returns
.Dv NULL
if a system
error occurs (in which case,
@@ -125,11 +127,13 @@ takes an Internet address and returns an
.Tn ASCII
string representing the address in
.Ql \&.
-notation. The routine
+notation.
+The routine
.Fn inet_makeaddr
takes an Internet network number and a local
network address and constructs an Internet address
-from it. The routines
+from it.
+The routines
.Fn inet_netof
and
.Fn inet_lnaof
@@ -155,8 +159,8 @@ a
.Pp
When four parts are specified, each is interpreted
as a byte of data and assigned, from left to right,
-to the four bytes of an Internet address. Note
-that when an Internet address is viewed as a 32-bit
+to the four bytes of an Internet address.
+Note that when an Internet address is viewed as a 32-bit
integer quantity on a system that uses little-endian
byte order (such as the
.Tn Intel 386, 486
@@ -214,16 +218,20 @@ every field (except for the case described in 2.).
.It
Due to the method of allocating certain styles of IPv6
addresses, it will be common for addresses to contain long
-strings of zero bits. In order to make writing addresses
+strings of zero bits.
+In order to make writing addresses
.Pp
containing zero bits easier a special syntax is available to
-compress the zeros. The use of
+compress the zeros.
+The use of
.Dq \&:\&:
indicates multiple groups
-of 16 bits of zeros. The
+of 16 bits of zeros.
+The
.Dq \&:\&:
can only appear once in an
-address. The
+address.
+The
.Dq \&:\&:
can also be used to compress the leading and/or trailing zeros in an address.
.Pp
@@ -248,7 +256,8 @@ dealing with a mixed environment of IPv4 and IPv6 nodes is
x:x:x:x:x:x:d.d.d.d, where the 'x's are the hexadecimal values
of the six high-order 16-bit pieces of the address, and the 'd's
are the decimal values of the four low-order 8-bit pieces of the
-address (standard IPv4 representation). Examples:
+address (standard IPv4 representation).
+Examples:
.Bd -literal -offset indent
0:0:0:0:0:0:13.1.68.3
0:0:0:0:0:FFFF:129.144.52.38
@@ -281,10 +290,12 @@ The
and
.Nm inet_pton
functions conforms to the IETF IPng BSD API and address formatting
-specifications. Note that
+specifications.
+Note that
.Nm inet_pton
-does not accept 1-, 2-, or 3-part dotted addresses; all four parts
-must be specified. This is a narrower input set than that accepted by
+does not accept 1-, 2-, or 3-part dotted addresses; all four parts
+must be specified.
+This is a narrower input set than that accepted by
.Nm inet_aton .
.Sh HISTORY
The
diff --git a/lib/libc/net/inet6_rthdr_space.3 b/lib/libc/net/inet6_rthdr_space.3
index 439c2703572..6c84bdee78f 100644
--- a/lib/libc/net/inet6_rthdr_space.3
+++ b/lib/libc/net/inet6_rthdr_space.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: inet6_rthdr_space.3,v 1.4 2000/01/18 21:49:01 aaron Exp $
+.\" $OpenBSD: inet6_rthdr_space.3,v 1.5 2000/04/18 03:01:32 aaron Exp $
.\"
.\" Copyright (c) 1983, 1987, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -70,8 +70,8 @@
.\"
.Sh DESCRIPTION
RFC2292 IPv6 advanced API defines eight
-functions that the application calls to build and examine a Routing
-header. Four functions build a Routing header:
+functions that the application calls to build and examine a Routing header
+Four functions build a Routing header:
.Bl -hang
.It Fn inet6_rthdr_space
return #bytes required for ancillary data
@@ -107,7 +107,8 @@ containing the specified number of
.Fa segments
.Pq addresses .
For an IPv6 Type 0 Routing header, the number
-of segments must be between 1 and 23, inclusive. The return value
+of segments must be between 1 and 23, inclusive.
+The return value
includes the size of the cmsghdr structure that precedes the Routing
header, and any required padding.
.Pp
diff --git a/lib/libc/net/inet_net.3 b/lib/libc/net/inet_net.3
index 1eb157c429d..12b1a4daa0e 100644
--- a/lib/libc/net/inet_net.3
+++ b/lib/libc/net/inet_net.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: inet_net.3,v 1.4 1999/07/05 04:40:59 aaron Exp $
+.\" $OpenBSD: inet_net.3,v 1.5 2000/04/18 03:01:32 aaron Exp $
.\" $NetBSD: inet_net.3,v 1.1 1997/06/18 02:25:27 lukem Exp $
.\"
.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
@@ -101,8 +101,8 @@ a
.Pp
When four parts are specified, each is interpreted
as a byte of data and assigned, from left to right,
-to the four bytes of an Internet network number. Note
-that when an Internet network number is viewed as a 32-bit
+to the four bytes of an Internet network number.
+Note that when an Internet network number is viewed as a 32-bit
integer quantity on a system that uses little-endian
byte order (such as the Intel 386, 486, and Pentium processors)
the bytes referred to above appear as
diff --git a/lib/libc/net/link_addr.3 b/lib/libc/net/link_addr.3
index b7ada819975..29c2449f77e 100644
--- a/lib/libc/net/link_addr.3
+++ b/lib/libc/net/link_addr.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: link_addr.3,v 1.6 1999/07/05 04:40:59 aaron Exp $
+.\" $OpenBSD: link_addr.3,v 1.7 2000/04/18 03:01:32 aaron Exp $
.\"
.\" Copyright (c) 1993
.\" The Regents of the University of California. All rights reserved.
@@ -108,7 +108,7 @@ The
and
.Fn link_ntoa
functions appeared in
-.Bx 4.3 Reno .
+.Bx 4.3 Reno .
.Sh BUGS
The returned values for link_ntoa
reside in a static memory area.
diff --git a/lib/libc/net/net_addrcmp.3 b/lib/libc/net/net_addrcmp.3
index c29624dc878..8f7de8ef445 100644
--- a/lib/libc/net/net_addrcmp.3
+++ b/lib/libc/net/net_addrcmp.3
@@ -26,7 +26,8 @@ returns 0.
.Pp
The
.Fa sa_len
-fields are compared first. If they do not match,
+fields are compared first.
+If they do not match,
.Fn net_addrcmp
returns \-1 or 1 if
.Li sa1->sa_len
@@ -36,7 +37,8 @@ respectively.
.Pp
Next, the
.Fa sa_family
-members are compared. If they do not match,
+members are compared.
+If they do not match,
.Fn net_addrcmp
returns \-1 or 1 if
.Li sa1->sa_family
@@ -51,7 +53,8 @@ and
fields match,
the protocol-specific data (the
.Fa sa_data
-field) is compared. If there's a match, both
+field) is compared.
+If there's a match, both
.Fa sa1
and
.Fa sa2
diff --git a/lib/libc/net/rcmd.3 b/lib/libc/net/rcmd.3
index ea71e40d71b..04230ef7745 100644
--- a/lib/libc/net/rcmd.3
+++ b/lib/libc/net/rcmd.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: rcmd.3,v 1.19 2000/04/15 11:46:02 aaron Exp $
+.\" $OpenBSD: rcmd.3,v 1.20 2000/04/18 03:01:33 aaron Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -65,7 +65,8 @@ The
function
is used by the superuser to execute a command on a remote
machine using an authentication scheme based on reserved
-port numbers. If the calling process is not setuid, the
+port numbers.
+If the calling process is not setuid, the
.Ev RSH
environment variable is set, and
.Fa inport
@@ -170,12 +171,12 @@ The
and
.Fn rresvport_af
functions are used to obtain a socket with a privileged
-address bound to it. This socket is suitable for use
-by
+address bound to it.
+This socket is suitable for use by
.Fn rcmd
-and several other functions. Privileged Internet ports are those
-in the range 0 to 1023. Only the superuser
-is allowed to bind an address of this sort to a socket.
+and several other functions.
+Privileged Internet ports are those in the range 0 to 1023.
+Only the superuser is allowed to bind an address of this sort to a socket.
.Fn rresvport
and
.Fn rresvport_af