GETRPCENT(3N)

NOME
getrpcent, getrpcbyname, getrpcbynumber - obtém entrada RPC

SINÓPSE
#include <netdb.h>

struct rpcent *getrpcent()

struct rpcent *getrpcbyname(name)
char *name;

struct rpcent *getrpcbynumber(number)
int number;

setrpcent (stayopen)
int stayopen

endrpcent ()

DESCRIÇÃO

getrpcent(), getrpcbyname(), e getrpcbynumber() cada uma retorna um ponteiro para um objeto com a seguinte estrutura contendo os campos já separados de uma linha do banco de dados de número do programa rpc /etc/rpc.

    struct	rpcent {
    	char	*r_name;	/* nome do servidor p/ este programa rpc */
    	char	**r_aliases;	/* lista de apelidos */
    	long	r_number;	/* número do programa rpc */
    };

Os membros desta estruruta são:
    r_name
        O nome do servidor para este programa rpc.
    r_aliases
        Uma lista terminada por zeros de nomes alternativos para o programa rpc.
    r_number
        O número do programa rpc para este serviço.

getrpcent() lê a próxima linha do arquivo, abrindo-o se necessário.

getrpcent() abre e retrocede o ponteiro do arquivo para o início. Se o sinalizador stayopen não é zero, o banco de dados de rede não será fechado depois de cada chamada feita a getrpcent() (diretamente ou indiretamente através de uma das outras chamadas “getrpc”).

endrpcent fecha o arquivo.

getrpcbyname() e getrpcbynumber() buscam sequencialmente a partir do início do arquivo até que seja encontrado um nome de programa rpc ou um número de programa igual, ou até o fim do arquivo.

ARQUIVOS
/etc/rpc

VEJA TAMBÉM
rpc(5), rpcinfo(8C), ypserv(8)

DIAGNÓSTICOS

Um ponteiro NULO é retornado quando alcançado o EOF ou erro.

PROBLEMAS

Toda informação está contida numa área estática e portanto deve ser copiada se é pra ser salva.

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>