GETPROTOENT(3)

NOME
getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent - obtém entrada de protocolo

SINÓPSE
#include <netdb.h>

struct protoent *getprotoent(void);

struct protoent *getprotobyname(const char *name);

struct protoent *getprotobynumber(int proto);

void setprotoent(int stayopen);

void endprotoent(void);

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

A função getprotobyname() retorna uma estrutura protoent para a linha de /etc/protocols na qual se iguala o nome do protocolo name.

A função getprotobynumber() retorna uma estrutura protoent para a linha na qual se iguala o número do protocolo number.

A função setprotoent() abre e retrocede o ponteiro do arquivo /etc/protocols para o início. Se stayopen é verdadeiro (1), o arquivo não será fechado entre chamadas a getprotobyname() ou getprotobynumber().

A função endprotoent() fecha /etc/protocols.

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

    struct protoent {
    	char	*p_name;		/* nome oficial do protocolo */
    	char	**p_aliases;		/* lista de apelidos */
    	int	p_proto;		/* número do protocolo */
    }

Os membros da estrutura protoent são:

p_name
    O nome oficial do protocolo.

p_aliases
    Um lista terminada por zero dos nomes alternativos para o protocolo.

p_proto
    O número do protocolo.

VALORES RETORNADOS
As funções getprotoent(), getprotobyname() e getprotobynumber() retornam a estrutura protoent, ou um ponteiro NULL se um erro ocorre ou o fim do arquivo é alcançado.

ARQUIVOS
/etc/protocols
    arquivo do banco de dados de protocolos

DE ACORDO COM
BSD 4.3.

VEJA TAMBÉM
getservent(3), getnetent(3), protocols(5).

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>