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:
|
r_name |
El nombre del servidor para este programa RPC. | ||
|
r_aliases |
Una lista terminada en NULL de nombres alternativos para el programa RPC. | ||
|
r_number |
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
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.