version 8, including all changes.
.
Rev |
Author |
# |
Line |
7 |
PerryLorier |
1 |
!!NAME |
|
|
2 |
|
|
|
3 |
|
|
|
4 |
inet_aton, inet_addr, inet_network, inet_ntoa, inet_makeaddr, inet_lnaof, inet_netof - Internet address manipulation routines |
|
|
5 |
!!SYNOPSIS |
|
|
6 |
__#include <sys/socket.h>__ |
|
|
7 |
__#include <netinet/in.h>__ |
|
|
8 |
__#include <arpa/inet.h>__ |
|
|
9 |
|
|
|
10 |
__int inet_aton(const char *__''cp''__, struct in_addr *__''inp''__);__ |
|
|
11 |
__in_addr_t inet_addr(const char *__''cp''__);__ |
|
|
12 |
__in_addr_t inet_network(const char *__''cp''__);__ |
|
|
13 |
__char *inet_ntoa(struct in_addr __''in''__);__ |
|
|
14 |
__struct in_addr inet_makeaddr(int __''net''__, int __''host''__);__ |
|
|
15 |
__in_addr_t inet_lnaof(struct in_addr __''in''__);__ |
|
|
16 |
__in_addr_t inet_netof(struct in_addr __''in''__);__ |
|
|
17 |
!!DESCRIPTION |
|
|
18 |
|
|
|
19 |
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'' |
|
|
20 |
points to. inet_aton(3) returns nonzero if the address is valid, zero if not. |
|
|
21 |
|
|
|
22 |
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, |
|
|
23 |
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 |
|
|
24 |
address (255.255.255.255), and inet_aton(3) provides a cleaner way to indicate error return. |
|
|
25 |
|
|
|
26 |
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. |
|
|
27 |
|
|
|
28 |
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 |
|
|
29 |
in a statically allocated buffer, which subsequent calls will overwrite. |
8 |
MikeBuland |
30 |
** Valgrind reports a memory leak when using this function. No solution has as of yet been found. |
7 |
PerryLorier |
31 |
|
|
|
32 |
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. |
|
|
33 |
|
|
|
34 |
|
|
|
35 |
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. |
|
|
36 |
|
|
|
37 |
|
|
|
38 |
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. |
|
|
39 |
|
|
|
40 |
|
|
|
41 |
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'' |
|
|
42 |
as: |
|
|
43 |
|
|
|
44 |
struct in_addr { |
|
|
45 |
unsigned long int s_addr; |
|
|
46 |
} |
|
|
47 |
|
|
|
48 |
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 |
|
|
49 |
first. |
|
|
50 |
|
|
|
51 |
!!CONFORMING TO |
|
|
52 |
|
|
|
53 |
|
|
|
54 |
BSD 4.3 |
|
|
55 |
!!SEE ALSO |
|
|
56 |
gethostbyname(3), getnetent(3), inet_ntop(3), inet_pton(3), hosts(5), networks(5) |