Differences between version 8 and predecessor to the previous major change of inet_ntoa(3).
Other diffs: Previous Revision, Previous Author, or view the Annotated Edit History
Newer page: | version 8 | Last edited on Thursday, January 8, 2004 6:59:41 am | by MikeBuland | Revert |
Older page: | version 4 | Last edited on Tuesday, June 4, 2002 12:24:24 am | by perry | Revert |
@@ -1,101 +1,56 @@
-INET
-!!!INET
-NAME
-SYNOPSIS
-DESCRIPTION
-CONFORMING TO
-SEE ALSO
-----
!!NAME
inet_aton, inet_addr, inet_network, inet_ntoa, inet_makeaddr, inet_lnaof, inet_netof - Internet address manipulation routines
!!SYNOPSIS
+ __#include <sys/socket.h>__
+ __#include <netinet/in.h>__
+ __#include <arpa/inet.h>__
-
-
__#include
-
__''cp''__, struct in_addr *__''inp''__);
-in_addr_t inet_addr(const char *__''cp''__);
-in_addr_t inet_network(const char *__''cp''__);
-char *inet_ntoa(struct in_addr__ ''in''__);
-struct in_addr inet_makeaddr(int__ ''net''__, int__ ''host''__);
-in_addr_t inet_lnaof(struct in_addr__ ''in''__);
-in_addr_t inet_netof(struct in_addr__ ''in''__);
-
__
+
__int inet_aton(const char *
__''cp''__, struct in_addr *__''inp''__);__
+ __
in_addr_t inet_addr(const char *__''cp''__);__
+ __
in_addr_t inet_network(const char *__''cp''__);__
+ __
char *inet_ntoa(struct in_addr __''in''__);__
+ __
struct in_addr inet_makeaddr(int __''net''__, int __''host''__);__
+ __
in_addr_t inet_lnaof(struct in_addr __''in''__);__
+ __
in_addr_t inet_netof(struct in_addr __''in''__);__
!!DESCRIPTION
+inet_aton(3) converts the Internet host address ''cp'' from the standard numbers-and-dots notation into binary data and stores it in the structure that ''inp''
+points to. inet_aton(3) returns nonzero if the address is valid, zero if not.
-__
inet_aton
()__
converts the Internet host address
-
''cp'' from the standard
numbers-and-dots notation into
-
binary data and stores it
in the structure that
''inp
''
-points
to.
__inet_aton__ returns nonzero if the address
-
is valid, zero if not
.
+The
inet_addr
(3
) function
converts the Internet host address ''cp'' from numbers-and-dots notation into binary data in network byte order. If
the input is invalid,
+INADDR_NONE (usually -1) is returned. This is an
''obsolete
'' interface
to __inet_aton__, described immediately above; it
is obsolete because -1 is a
valid
+address (255.255.255.255)
, and inet_aton(3) provides a cleaner way to indicate error return
.
+The inet_network(3) function extracts the network number in host byte order from the address ''cp'' in numbers-and-dots notation. If the input is invalid, -1 is returned.
-The __
inet_addr
()__
function converts the Internet host
-
address ''cp
'' from
numbers-and-dots notation into binary
-data in network byte order
. If the input is invalid,
-INADDR_NONE (usually -1)
is returned. This is an
-''obsolete'' interface to __inet_aton__
, described
-immediately above; it is obsolete because -1 is
a valid
-address (255
.255.255.255), and __inet_aton__ provides a
-cleaner way to indicate error return
.
+The inet_ntoa
(3
) function converts the Internet host address ''in
'' given in network byte order to a string in standard
numbers-and-dots notation. The string
is returned
+in a statically allocated buffer
, which subsequent calls will overwrite.
+** Valgrind reports
a memory leak when using this function
. No solution has as of yet been found
.
+The inet_makeaddr(3) function makes an Internet host address in network byte order by combining the network number ''net'' with the local address ''host'' in network ''net'', both in local host byte order.
-The __inet_network()__ function extracts the network
-number in host byte order from the address ''cp'' in
-numbers-and-dots notation. If the input is invalid, -1 is
-returned.
+The inet_lnaof(3) function returns the local host address part of the Internet address ''in''. The local host address is returned in local host byte order.
-The __inet_ntoa()__ function converts the Internet host
-address ''in'' given in network byte order to a string in
-standard numbers-and-dots notation. The string is returned
-in a statically allocated buffer, which subsequent calls
-will overwrite.
+The inet_netof(3) function returns the network number part of the Internet Address ''in''. The network number is returned in local host byte order.
-The __inet_makeaddr()__ function makes an Internet host
-address in network byte order by combining the network
-number ''net'' with the local address ''host'' in
-network ''net'', both in local host byte
-order.
-
-The __inet_lnaof()__ function returns the local host
-address part of the Internet address ''in''. The local
-host address is returned in local host byte
-order.
-
-
-The __inet_netof()__ function returns the network number
-part of the Internet Address ''in''. The network number
-is returned in local host byte order.
-
-
-
The structure ''in_addr'' as used in __
inet_ntoa()__
,
-__
inet_makeaddr()__
, __
inet_lnoaf()__
and
-__
inet_netof()__
is defined in ''netinet/in.h''
+The structure ''in_addr'' as used in inet_ntoa(3
), inet_makeaddr(3
), inet_lnoaf(3
) and inet_netof(3
) is defined in ''netinet/in.h''
as:
+ struct in_addr {
+ unsigned long int s_addr;
+ }
-struct in_addr {
-unsigned long int s_addr;
-}
+Note that on the i80x86 the host byte order is Least Significant Byte first, whereas the network byte order, as used on the Internet, is Most Significant Byte
+first.
-
-Note that on the i80x86 the host byte order is Least
-Significant Byte first, whereas the network byte order, as
-used on the Internet, is Most Significant Byte
-first.
!!CONFORMING TO
BSD 4.3
!!SEE ALSO
-
-
-
gethostbyname(3), getnetent(3),
-
inet_ntop(3), __
inet_pton__
(3), hosts(5),
-
networks(5)
-----
+gethostbyname(3), getnetent(3), inet_ntop(3), inet_pton(3), hosts(5), networks(5)