GETSERVENT(3)

NOME
getservent, getservbyname, getservbyport, setservent, endservent - obtém entrada de serviço

SINÓPSE
#include <netdb.h>

struct servent *getservent(void);

struct servent *getservbyname(const char *name, const char *proto);

struct servent *getservbyport(int port, const char *proto);

void setservent(int stayopen);

void endservent(void);

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

A função getservbyname() retorna uma estrutura servent para a linha de /etc/services que se iguala ao serviço name usando o protocolo proto. Se proto é NULO, qualquer protocolo será aceito.

A função getservbyport() retorna uma estrutura servent para a linha em que iguala à porta port dada na ordem de byte de rede usando o protocolo proto. Se proto é NULO, qualquer protocolo será aceito.

A função setservent() abre e retrocede o ponteiro do arquivo /etc/services para o início. Se stayopen é verdadeiro (1), então o arquivo não será fechado entre chamadas a getservbyname() e getservbyport().

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

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

    struct servent {
    	char	*s_name;		/* nome oficial de serviço */
    	char	**s_aliases;		/* lista de apelidos */
    	int	s_port;			/* número da porta */
    	char	*s_proto;		/* protocolo a utilizar */
    }

Os membros da estrutura servent são:

s_name
    O nome oficial do serviço.

s_aliases
    Uma lista terminada em zero de nomes alternativos para o serviço.

s_port
    O número de porta para o serviço dado na ordem de byte de rede.

s_proto
    O nome do protocolo a utilizar com este serviço.

VALORES RETORNADOS
As funções getservent(), getservbyname() e getservbyport() retornam a estrutura servent, um um ponteiro NULL se um erro ocorre ou o fim do arquivo é alcançado.

ARQUIVOS

/etc/services
    arquivo do banco de dados de serviços

DE ACORDO COM
BSD 4.3

VEJA TAMBÉM
getprotoent(3), getnetent(3), services(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>