GETNETENT(3)

NOME
getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - obtém entrada de rede

SINÓPSE
#include <netdb.h>

struct netent *getnetent(void);

struct netent *getnetbyname(const char *name);

struct netent *getnetbyaddr(long net, int type);

void setnetent(int stayopen);

void endnetent(void);

DESCRIÇÃO
A função getnetent() lê a próxima linha do arquivo /etc/networks e retorna uma estrutura netent contendo os campos já quebrados a partir da linha lida. O arquivo /etc/networks é aberto se necessário.

A função getnetbyname() retorna uma estrutura netent para a linha lida de /etc/networks que casa com a rede denominada por name.

A função getnetbyaddr() retorna uma estrutura netent para a linha que casa com o númer de rede net do tipo type.

A função setnetent() abre e retrocede o ponteiro do arquivo /etc/networks para o início. Se stayopen é verdadeiro (1), o arquivo não será fechado entre chamadas a getnetbyname() e getnetbyaddr().

A função endservent() fecha o arquivo /etc/networks.

A estrutura netent está definida em <netdb.h> como segue:

    struct netent {
    	char	*n_name;		/* nome oficial da rede */
    	char	**n_aliases;		/* lista de apelidos */
    	int	n_addrtype;		/* tipo de endereço da rede */
    	unsigned long int n_net;	/* número da rede */
    }

Os membros da estrutura netent são:

n_name
    O nome oficial da rede.

n_aliases
    Uma lista terminada por zero de nomes alternativos para a rede.

n_addrtype
    O tipo do número da rede; sempre AF_INET.

n_net
    O número da rede em ordem de byte do host.

VALORES RETORNADOS
As funções getnetent(), getnetbyname() e getnetbyaddr() retornam a estrutura netent, ou um ponteiro NULL se um erro ocorre ou o fim do arquivo é alcançado.

ARQUIVOS
/etc/networks arquivo do banco de dados de redes

DE ACORDO COM
BSD 4.3.

VEJA TAMBÉM
getprotoent(3), getservent(3), networks(5).
RFC 1101.

TRADUZIDO POR LDP-BR em 28/05/2001.

  Tradução:
Felipe M Pereira <Felipe.Pereira@ic.unicamp.br>

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