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¶
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.