INET(3)

NOME
inet_aton, inet_addr, inet_network, inet_ntoa, inet_makeaddr, inet_lnaof, inet_netof - rotinas para manipulação de endereços Internet

SINÓPSE
#include <sys/socket.h>
#include <netinet/in.h>
#include <arpa/inet.h>

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);

DESCRIÇÃO
inet_aton() converte o endereço de 'host' Internet cp da notação padrão de números e pontos para dados binários e os armazena na estrutura para a qual inp aponta. inet_aton retorna não zero se o endereço for válido, zero se não for.

A função inet_addr() converte o endereço de 'host' Internet cp da notação de números e pontos para dados binários na ordem de bytes da rede. Se a entrada for inválida, INADDR_NONE (geralmente -1) é retornado. Isso é uma interface obsoleta para inet_aton, descrita imediatamente acima; ela é obsoleta porque -1 é um endereço válido (255.255.255.255), e inet_aton oferece uma maneira mais clara de indicar retorno de erro.

A função inet_network() extrai o número de rede, em ordem de byte do 'host', do endereço cp para notação de números e pontos. Se a entrada for inválida, -1 é devolvido.

A função inet_ntoa() converte o endereço de 'host' Internet in, dado em ordem de byte da rede, para uma seqüencia na notação padrão de números e pontos. A seqüencia é retornada em um trecho de memória estaticamente alocado, que será sobrescrito por chamadas subseqüentes.

A função inet_makeaddr() cria um endereço de 'host' Internet em ordem de byte da rede pela combinação do número de rede net com o endereço local 'host' na rede net, ambos em ordem de byte do 'host' local.

A função inet_lnaof() retorna a parte do endereço de 'host' local do endereço Internet in. O endereço de 'host' local é retornado em ordem de byte do 'host' local.

A função inet_netof() retorna a parte do número de rede do endereço Internet in. O número de rede é retornado em ordem de byte do 'host' local.

A estrutura in_addr como usada em inet_ntoa(), inet_makeaddr(), inet_lnoaf() e inet_netof() é definida em netinet/in.h como:

    struct in_addr {
    	unsigned long int s_addr;
    }

Note que no i80x86 a ordem de byte do 'host' local é Byte Menos Significativo primeiro, enquanto que a ordem de byte da rede, como usado na Internet, é Byte Mais Significativo primeiro.

DE ACORDO COM
BSD 4.3.

VEJA TAMBÉM
gethostbyname(3), getnetent(3), inet_ntop(3), inet_pton(3), hosts(5), networks(5).

TRADUZIDO POR LDP-BR em 10/06/2001.

  Tradução:
Marcelo M. de Abreu <mmabreu@terra.com.br>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>