mirror of
https://github.com/freebsd/freebsd-src
synced 2024-10-02 22:54:52 +00:00
inet(3): clarify syntax accepted by inet_pton
The section INTERNET ADDRESSES describes the acceptance of dotted values with varying number of parts in multiple bases. This applies to inet_aton and inet_addr, but not to inet_pton. Clarify this section by listing the functions to which this applies. Move the description of what inet_pton accepts into this section from STANDARDS, where it is easily missed. Rename the section to clarify that it applies only to IPv4. (inet_pton also works with IPv6.) Reviewed by: imp Differential Revision: https://reviews.freebsd.org/D43537
This commit is contained in:
parent
72dd306e44
commit
9231c42127
|
@ -173,10 +173,15 @@ All Internet addresses are returned in network
|
|||
order (bytes ordered from left to right).
|
||||
All network numbers and local address parts are
|
||||
returned as machine byte order integer values.
|
||||
.Sh INTERNET ADDRESSES
|
||||
Values specified using the
|
||||
.Sh INTERNET ADDRESSES (IP VERSION 4)
|
||||
The
|
||||
.Fn inet_aton
|
||||
and
|
||||
.Fn inet_addr
|
||||
functions accept IPv4
|
||||
values specified using the
|
||||
.Ql .\&
|
||||
notation take one
|
||||
notation in one
|
||||
of the following forms:
|
||||
.Bd -literal -offset indent
|
||||
a.b.c.d
|
||||
|
@ -210,6 +215,13 @@ may be decimal, octal, or hexadecimal, as specified
|
|||
in the C language (i.e., a leading 0x or 0X implies
|
||||
hexadecimal; otherwise, a leading 0 implies octal;
|
||||
otherwise, the number is interpreted as decimal).
|
||||
.Pp
|
||||
Note that
|
||||
.Fn inet_pton
|
||||
does not accept 1-, 2-, or 3-part dotted addresses; all four parts
|
||||
must be specified and are interpreted only as decimal values.
|
||||
This is a narrower input set than that accepted by
|
||||
.Fn inet_aton .
|
||||
.Sh DIAGNOSTICS
|
||||
The constant
|
||||
.Dv INADDR_NONE
|
||||
|
@ -256,12 +268,6 @@ and
|
|||
.Fn inet_pton
|
||||
functions conform to
|
||||
.St -xns5.2 .
|
||||
Note that
|
||||
.Fn inet_pton
|
||||
does not accept 1-, 2-, or 3-part dotted addresses; all four parts
|
||||
must be specified and are interpreted only as decimal values.
|
||||
This is a narrower input set than that accepted by
|
||||
.Fn inet_aton .
|
||||
.Sh HISTORY
|
||||
These
|
||||
functions appeared in
|
||||
|
|
Loading…
Reference in a new issue