Scroll to navigation

GETRPCENT(3) Library Functions Manual GETRPCENT(3)

NOMBRE

getrpcent, getrpcbyname, getrpcbynumber - obtienen una entrada RPC

SINOPSIS

#include <netdb.h>
struct rpcent *getrpcent()
struct rpcent *getrpcbyname(name)
char *name;
struct rpcent *getrpcbynumber(number)
int number;
setrpcent (stayopen)
int stayopen;
endrpcent ()

DESCRIPCIÓN

getrpcent(), getrpcbyname() y getrpcbynumber() devuelven un puntero a un objeto con la siguiente estructura, que contiene los campos extraídos de una línea de la base de datos de números de programas RPC, /etc/rpc.

struct	rpcent {
	char	*r_name;	/* nom. del servidor para este programa RPC */
	char	**r_aliases;	/* lista de alias */
	long	r_number;	/* número del programa RPC */
};

Los miembros de esta estructura son:

El nombre del servidor para este programa RPC.
Una lista terminada en NULL de nombres alternativos para el programa RPC.
El número del programa RPC para este servicio.

getrpcent() lee la siguiente línea del fichero, abriendo el fichero si es necesario.

setrpcent() abre el fichero y coloca su puntero de lectura/escritura al principio. Si la opción stayopen no es cero, la base de datos de red no se cerrará tras cada llamada a getrpcent() (tampoco ni directa ni indirectamente a través de alguna de las otras llamadas “getrpc”).

endrpcent cierra el fichero.

getrpcbyname() y getrpcbynumber() examinan secuencialmente el fichero, desde el principio, hasta que encuentran un nombre de programa RPC o un número de programa coincidente, o hasta que se encuentre el final del fichero.

FICHEROS

/etc/rpc

VÉASE TAMBIÉN

rpc(5), rpcinfo(8), ypserv(8)

DIAGNÓSTICOS

Se devuelve un puntero NULL si se encuentra un EOF o si se produce un error.

FALLOS

Toda la información se almacenada en un área estática por lo que debe copiarse a otro sitio si se va a guardar.

14 diciembre 1987